让Tomcat支持中文路径名和中文文件名

   Tomcat是Java开发者使用得较多的一个Web服务器，因为它占用资源小，运行速度快等特点，深受Java Web程序员的喜爱。不过，在使用中，由于Java中的中文问题的存在，如果不经过配置，在WEB程序中，不能直接支持具有中文文件名的文件的下载，这为Java Web程序的开发带来一定的不便。本文拟介绍一种手段，解决这个问题。

   解决问题的核心在于修改Tomcat的配置，在Server.xml文件中添加一个名为URIEncoding的属性，它用于对HTTP请求中的get方法传过来的URL进行编码。如果直接从Apache站点中下载Tomcat，无论是安装版的exe文件，还是解压缩的ZIP文件，内置的对于get协议中的URL编码都是ISO-8859-1,这个字符集不能直接支持中文等双字节的信息，而中文文件的下载链接恰恰是通过get协议进行的。以下说明修改Tomcat安装目录中的config文件夹中的server.xml文件的方法。

   打开config/server.xml文件，如果没有修改过这个文件，应该可以在其中找到如下代码：
  
   <Connector port="8080"  protocol="HTTP/1.1"
               connectionTimeout="20000"
               redirectPort="8443" />
  
   这段代码规定了Tomcat监听HTTP请求的端口号等信息，可以在这里添加一个属性：URIEncoding，将该属性值设置为UTF-8，即可让Tomcat不再以ISO-8859-1的编码处理get请求。更改后的代码如下所示（红色部分为新添加的代码）：
 
  <Connector port="8080"
             URIEncoding="utf-8"
             protocol="HTTP/1.1"
             connectionTimeout="20000"
             redirectPort="8443" />
 
  下面，我们准备测试一下更改后的效果。

   最为简单的测试方法就是让Tomcat自己列出WEB程序中的目录和文件，默认情况下，Tomcat不会直接列出WEB程序目录中的文件和文件夹，但是，我们可以修改位于安装目录中的config文件夹中的web.xml，使其能够支持自动列出WEB程序中的目录和文件。
   在config/web.xml文件中找到如下代码：
  
    <servlet>
    <servlet-name>default</servlet-name>
    <servlet-class>org.apache.catalina.servlets.DefaultServlet</servlet-class>
    <init-param>
      <param-name>debug</param-name>
      <param-value>0</param-value>
    </init-param>
    <init-param>
      <param-name>listings</param-name>
      <param-value>false</param-value>
    </init-param>
    <load-on-startup>1</load-on-startup>
  </servlet>
  
   将上面的代码中标为红色的部分改为如下内容：
 
   <init-param>
      <param-name>listings</param-name>
      <param-value>true</param-value>
   </init-param>
  

   即将参数listings的属性改为true，就可让Tomcat自动列出某个WEB程序目录中的文件和文件夹。

   现在，我们的设置已经完成，将修改的文件保存后，就可以启动Tomcat进行测验了，当然，如果Tomcat正在运行，则需要重新启动，以便配置生效。

   现在，可以在Tomcat安装目录中的webapps目录中建立一个名为cntest的文件夹，作为测试的web程序的上下文路径（注意：对于WEB程序的上下文路径，请不要使用中文）。请在cntest中添加一些中文目录和文件，然后在浏览器中打开该WEB程序，如，http://localhost:8080/cntest，测验一下效果吧。当然，也可以在JSP或HTML文件中使用那些包含中文的文件夹或文件名的超级链接。

   说明：以上修改均使用Tomcat5.5做的测试，在5.5以上都应该可以，至于5.0和4.x，我没有实验过，不过对于5.0应该也是可以的，但4.x不能保证（4.x在处理HTTP的get和post方法和5.x不大一样）。

评论

1 楼 maimode 2014-12-04  

非常感谢！

我用apache-tomcat-6.0.43试了一下，只需把conf/server.xml文件中增加URIEncoding="utf-8"这个参数即可。
webapps目录下也是可以直接放中文目录的。

搜索了一下原因：
[url]
http://zhidao.baidu.com/link?url=H6jDQUASdvVj06kbNqZ_UM7Pi26YaowmCbEJzstXjpqEXXYkJVwt8-O74wAcXQpDS77rJ2VWSt9KIrzKF-ra5K
[/url]

引用

这并不是tomcat的问题，而是url编码规则规定不能含有中文等非ASCII字符，如果有这种字符，浏览器会自动对它们进行url encode，在tomcat中设置URIEncoding为gb2312或utf-8只能让我们能正确反编码提取url中的中文信息。