OpenJDK进程不读取系统locale，必须显式传参：-Dfile.encoding=UTF-8和-Dsun.jnu.encoding=UTF-8解决编码乱码，需配合系统生成zh_CN.UTF-8 locale数据及安装中文字体才能确保中文可靠显示。
OpenJDK进程不读取系统locale，必须显式传参
Java虚拟机默认忽略系统的LANG和LC_ALL，哪怕locale命令显示zh_CN.UTF-8，java -version输出或日志里仍可能乱码。根本原因是JVM启动时未主动读取glibc locale数据，而是回退到C locale——这会导致String.getBytes()、FileReader、日志框架编码等全部按ASCII处理。
解决办法只有一条：在启动Java应用时，强制注入JVM参数：
-
-Dfile.encoding=UTF-8：确保所有基于平台默认编码的API（如new String(byte[])）使用UTF-8 -
-Dsun.jnu.encoding=UTF-8：修复文件路径、系统属性名等JNI层编码（尤其影响System.getProperty("user.home")含中文路径时） - （可选）
-Duser.language=zh -Duser.country=CN：影响DateFormat、NumberFormat等本地化格式，但不解决乱码本身
示例启动命令：java -Dfile.encoding=UTF-8 -Dsun.jnu.encoding=UTF-8 -jar app.jar
Linux系统locale必须真实生成，不能只设环境变量
很多用户以为在/etc/environment或~/.bashrc里加export LANG=zh_CN.UTF-8就够了，但OpenJDK容器或systemd服务常因未继承shell环境而失效。更关键的是：Debian/Ubuntu镜像（包括openjdk:17-jre-slim）默认根本不带zh_CN.UTF-8 locale数据——locale -a | grep zh_CN返回空，此时仅设ENV LANG纯属无效操作。
正确做法是构建阶段生成locale：
- Debian/Ubuntu系：
RUN apt-get update && apt-get install -y locales && locale-gen zh_CN.UTF-8 && update-locale LANG=zh_CN.UTF-8 - Alpine系：
RUN apk add --no-cache tzdata musl-locales && cp /usr/share/locale/zh_CN.UTF-8/LC_ALL /etc/locale.conf - 然后才设环境变量：
ENV LANG=zh_CN.UTF-8 LC_ALL=zh_CN.UTF-8
验证是否生效：docker run your-image locale -a | grep zh_CN必须有输出。
中文显示为方块？缺字体不是JVM问题
即使file.encoding和系统locale全对，Swing GUI、JavaFX或日志中打印的中文在终端里仍显示为□或，大概率是字体缺失。JVM本身不渲染文字，它把字符串交给系统图形栈或终端，而后者需要可用的中文字体文件。
在Docker镜像中，必须显式安装字体包：
- Debian/Ubuntu：
RUN apt-get install -y fonts-wqy-microhei fonts-dejavu-core - Alpine：
RUN apk add --no-cache ttf-dejavu ttf-droid - 验证字体存在：
fc-list :lang=zh应列出文泉驿或Noto Sans CJK等字体
注意：fonts-wqy-microhei比fonts-wqy-zenhei体积小、兼容性更好，适合容器场景。
systemd服务或后台进程容易漏掉locale继承
用systemctl start myapp.service启动Java服务时，即使/etc/default/locale已设LANG=zh_CN.UTF-8，服务仍可能以C locale运行。因为systemd默认不传递用户级locale变量，且EnvironmentFile若未显式加载，LANG不会自动注入。
修复方式（任选其一）：
- 在service文件中硬编码：
Environment="LANG=zh_CN.UTF-8" "LC_ALL=zh_CN.UTF-8" - 启用全局locale继承：
sudo systemctl edit systemd-localed.service，添加[Service] EnvironmentFile=/etc/default/locale - 最稳妥：直接在
ExecStart里带JVM参数，例如：ExecStart=/usr/bin/java -Dfile.encoding=UTF-8 ...
检查服务实际环境：systemctl show --property=Environment myapp.service或ps aux | grep java确认参数已注入。
真正卡住人的点从来不是“设没设”，而是“有没有生成locale数据”“JVM参数有没有随进程一起启动”“字体文件存不存在于运行时根文件系统”。三者缺一，中文就不可靠。
