Ubuntu下Java乱码排查与修复
一、先定位乱码来源
- 检查系统本地化：运行命令查看是否为UTF-8，例如输出应包含en_US.UTF-8或zh_CN.UTF-8。若不是，请先修正系统编码。
- 查看：locale
- 临时修正：export LANG=en_US.UTF-8（或 zh_CN.UTF-8）；如需持久化，执行：sudo update-locale LANG=en_US.UTF-8
- 区分场景：是终端/日志输出乱码、Swing/AWT界面方块字、还是读取文件/数据库后乱码。不同场景的修复点不同（见下表）。
二、通用修复步骤
- 统一Java运行时编码：在启动命令中显式指定UTF-8。
- java -Dfile.encoding=UTF-8 -jar app.jar
- 若允许改代码，在程序入口尽早设置：System.setProperty(“file.encoding”, “UTF-8”)（注意：部分API可能已缓存默认编码，越早设置越好）。
- 编译期编码一致：源码保存为UTF-8并在编译时声明。
- javac -encoding UTF-8 YourProgram.java
- 终端与显示环境：确保终端本身使用UTF-8，否则即使Java输出正确也会在终端显示异常。
- 服务器/容器场景：在启动脚本（如catalina.sh）或环境变量中统一加入：-Dfile.encoding=UTF-8。
- 涉及Oracle客户端时：设置客户端字符集环境变量，例如：export NLS_LANG=AL32UTF8。
三、按场景给出命令与配置
| 场景 |
症状 |
修复要点 |
示例命令/配置 |
| 终端/日志输出乱码 |
控制台中文成方块/问号 |
系统locale与终端均为UTF-8；Java启动显式指定UTF-8 |
locale；export LANG=en_US.UTF-8；java -Dfile.encoding=UTF-8 … |
| 读取文件乱码 |
文件内容读出来是问号/错字 |
编译与读取均显式用UTF-8 |
javac -encoding UTF-8；new InputStreamReader(new FileInputStream(f), “UTF-8”) |
| 数据库（如MySQL）乱码 |
入库/出库中文变??? |
DB、连接、表/列、客户端统一UTF-8；JDBC URL加characterEncoding=UTF-8 |
jdbc:mysql://…?characterEncoding=UTF-8 |
| Swing/AWT界面方块字 |
GUI中文不显示 |
安装中文字体并配置Java字体fallback |
sudo apt-get install ttf-wqy-zenhei；在JRE/lib/fonts下建fallback并链接中文字体 |
| Web应用日志/页面乱码 |
日志或页面中文异常 |
容器/应用统一UTF-8（如Tomcat JAVA_OPTS加-Dfile.encoding=UTF-8），响应头与模板编码一致 |
JAVA_OPTS=“$JAVA_OPTS -Dfile.encoding=UTF-8” |
上述要点与示例命令覆盖了系统、编译/运行、文件IO、数据库与界面渲染等常见环节，可逐项对照排查。
四、快速自检脚本
- 保存为TestEncoding.java，编译并运行，观察输出是否为“你好，世界！”
- javac -encoding UTF-8 TestEncoding.java
- java -Dfile.encoding=UTF-8 TestEncoding
- 若终端仍显示异常，优先检查终端自身的编码设置是否为UTF-8（见第二部分）。
五、常见坑与建议
- 不要依赖平台默认编码：始终在编译与运行时显式指定UTF-8。
- 源码、编译、运行、数据库、HTTP请求/响应、日志框架的编码要一致。
- 修改系统locale后建议重启或重新登录会话，使其生效。
- 使用zip等压缩包时，注意其条目名编码（常见为GBK），读取时按实际编码处理，避免中文文件名乱码。
- 若涉及Oracle相关工具，记得设置NLS_LANG与数据库字符集一致。
