Using non-ASCII characters on a production deployment or running the Build Verification Test (BVT) in development require that your server supports UTF-8 URI encoding. If running Tomcat 7.0.x, you need to modify your server configuration in <CATALINA_HOME>/conf/server.xml to specify this encoding. Add the following attributes to your Connector element:


For example, the modified Tomcat non-SSL HTTP/1.1 connector might appear as follows:

<!-- Define a non-SSL HTTP/1.1 Connector on port 8080 -->
<Connector port="8080" maxHttpHeaderSize="8192"
maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
enableLookups="false" redirectPort="8443" acceptCount="100"
connectionTimeout="20000" disableUploadTimeout="true"
useBodyEncodingForURI="true" URIEncoding="UTF-8"/>

For more information on configuring Tomcat HTTP connectors, see the Tomcat documentation at:

URIEncoding defaults to UTF-8 with later versions, so this step is not required for Tomcat 8.5.x or 9.0.x.

Related Topics


Was this content helpful?

Log in or register an account to provide feedback

expand all collapse all