CentOS7下Tomcat7无法读写日文目录结构，Docker环境正常

开发者阿泽

2026-8-4

解决CentOS 7下Tomcat 7读取日文目录时的FileNotFoundException问题

问题场景

在CentOS 7系统的Tomcat 7 Web应用中读取带日文的目录结构时，触发FileNotFoundException异常，但相同操作在Docker容器内或直接通过Java控制台执行却能正常运行。已完成的配置包括：

在Tomcat的server.xml文件的Connector标签中添加URIEncoding="UTF-8"属性

在catalina.sh中添加如下配置：

export JAVA_OPTS="$JAVA_OPTS -server \
   -XX:-UseGCOverheadLimit \
   -Djava.awt.headless=true \
   -Djavax.servlet.request.encoding=UTF-8 \
   -Dfile.encoding=UTF-8"

export CATALINA_OPTS="$CATALINA_OPTS \
   -Dfile.encoding='UTF-8'"

执行命令export LC_ALL=en_US.UTF-8修改服务器语言

排查与解决步骤

1. 确认Tomcat进程的环境变量继承

直接运行Java或Docker时，进程能正确获取UTF-8相关环境变量，但Tomcat启动时可能没继承到。可以通过以下步骤验证：

查找Tomcat进程ID：ps aux | grep tomcat
查看进程的环境变量：cat /proc/<你的TomcatPID>/environ | tr '\0' '\n' | grep -E "(LC_ALL|LANG|file.encoding)"
如果输出中没有LC_ALL=en_US.UTF-8或LANG=en_US.UTF-8，说明Tomcat启动时未加载该变量。解决方法：将export LC_ALL=en_US.UTF-8写入Tomcat启动用户的~/.bash_profile或系统全局的/etc/profile，重启Tomcat后再次验证。

2. 检查文件系统挂载编码

CentOS 7的文件系统默认编码可能不是UTF-8，导致日文目录名无法正确解析：

查看目标目录所在分区的挂载参数：mount | grep <目录所在分区>
确认挂载项包含utf8或charset=utf-8参数。如果没有，修改/etc/fstab添加对应参数，例如：

/dev/sda1 / ext4 defaults,utf8 1 1

修改后执行mount -o remount /重新挂载分区。

3. 验证Tomcat启动参数的有效性

虽然在catalina.sh中设置了file.encoding，但需确保参数真正生效：

查看Tomcat启动日志catalina.out，搜索file.encoding，确认输出值为UTF-8。
如果参数未生效，检查catalina.sh的修改位置，建议将配置放在脚本开头（#!/bin/bash之后），确保启动时被执行。

4. 显式指定Java文件操作的编码

Web应用中读取目录时，避免依赖系统默认编码，显式用UTF-8解析路径：

// 方式1：显式转码
File japaneseDir = new File(new String("日文目录名称".getBytes("UTF-8"), "UTF-8"));

// 方式2：使用URI编码
String encodedPath = URLEncoder.encode("日文目录名称", "UTF-8");
Path dirPath = Paths.get(URI.create("file:///" + encodedPath));

5. 排查SELinux限制

CentOS 7默认开启SELinux，可能阻止Tomcat访问特定目录：

临时关闭SELinux测试：setenforce 0，若问题解决，需为目录设置正确的SELinux上下文：

chcon -R -t tomcat_web_content_t /path/to/你的日文目录

或者根据需求添加SELinux规则，避免永久关闭SELinux带来的安全风险。

内容的提问来源于stack exchange，提问作者Yaseen