Home » Core Java » net » URISyntaxException » java.net.URISyntaxException – How to solve URISyntaxException

About Nikos Maravitsas

Nikos has graduated from the Department of Informatics and Telecommunications of The National and Kapodistrian University of Athens. During his studies he discovered his interests about software development and he has successfully completed numerous assignments in a variety of fields. Currently, his main interests are system’s security, parallel systems, artificial intelligence, operating systems, system programming, telecommunications, web applications, human – machine interaction and mobile development.

java.net.URISyntaxException – How to solve URISyntaxException

In this example we are going to talk about java.net.URISyntaxException. This is a checked exception that occurs when you are trying to parse a string that represents a URI, but it doesn’t have the correct format.

1. A simple example of URISyntaxException

Let’s see a program that parses a legal URI:



package com.javacodegeeks.core.net.urisyntaxexception;

import java.net.URI;
import java.net.URISyntaxException;

public class URISyntaxExceptioExample {

	public static void main(String[] args) {

		try {
			URI uri = new URI("http://www.javacodegeeks.com/");
			System.out.println("URI parsed succesfully!");
		} catch (URISyntaxException e) {

This will output:

URI parsed succesfully!

Now let’s add an illegal character to the URI, let’s say a space. So let’s change:

URI uri = new URI("http://www.javacodegeeks.com/");


URI uri = new URI("http://www. javacodegeeks.com/");

If you run this, it will output:

java.net.URISyntaxException: Illegal character in authority at index 7: http://www. javacodegeeks.com/
	at java.net.URI$Parser.fail(URI.java:2829)
	at java.net.URI$Parser.parseAuthority(URI.java:3167)
	at java.net.URI$Parser.parseHierarchical(URI.java:3078)
	at java.net.URI$Parser.parse(URI.java:3034)
	at java.net.URI.(URI.java:595)
	at com.javacodegeeks.core.net.urisyntaxexception.URISyntaxExceptioExample.main(URISyntaxExceptioExample.java:12)

As you can see, URISyntaxException is accompanied with a very informative message that tells you where exactly the problem is.

2. How to solve URISyntaxException

To avoid this exception, it is important to to perform checks against the strings you want to parse. You can do that using regular expressions. Additionally, you should try to perform URI encoding before parsing your strings. This process, will remove illegal characters from the strings and on the same time encode special character to the correct format.

Download Source Code

This was an example on java.net.URISyntaxException and how to solve URISyntaxException. You can download the source code of this example here : URISyntaxExceptionExample.zip

Do you want to know how to develop your skillset to become a Java Rockstar?

Subscribe to our newsletter to start Rocking right now!

To get you started we give you our best selling eBooks for FREE!


1. JPA Mini Book

2. JVM Troubleshooting Guide

3. JUnit Tutorial for Unit Testing

4. Java Annotations Tutorial

5. Java Interview Questions

6. Spring Interview Questions

7. Android UI Design


and many more ....


Receive Java & Developer job alerts in your Area


Notify of

This site uses Akismet to reduce spam. Learn how your comment data is processed.

Inline Feedbacks
View all comments