Java应用Docker中文乱码主因是容器缺中文字体、JVM默认编码非UTF-8及字节流解码断裂，需从镜像层装字体、JVM层设-Dfile.encoding=UTF-8、应用层显式指定UTF-8编码三方面协同解决。

Java 应用在 Docker 容器中出现中文乱码，核心原因不是代码写错了，而是容器环境缺失关键支持：**系统级中文字体 + JVM 默认编码未对齐 + 字节流解码链路断裂**。它常表现为控制台输出方块、PDF/图表中文变问号、日志文件乱码等。解决需从镜像层、JVM 层、应用层三方面协同处理。

确认并统一 JVM 字符编码

容器内 JVM 默认编码往往继承自精简镜像的 locale（如 C 或 POSIX），不是 UTF-8。必须显式指定：

• 启动 Java 命令时加参数：-Dfile.encoding=UTF-8
• 若用 Spring Boot，可在 java -jar 命令后直接追加该参数；Dockerfile 中写成：RUN java -Dfile.encoding=UTF-8 -jar app.jar
• 验证是否生效：在应用里打印 System.getProperty("file.encoding")，应输出 UTF-8

为 Alpine 或 Debian 镜像安装中文字体

OpenJDK 官方镜像（如 openjdk:8-jre-alpine 或 openjdk:17-slim）不带中文字体，Java2D 渲染中文图形（如生成 PDF、图表、验证码）时会 fallback 到无中文的字体，导致方块 □。

• Alpine 镜像：在 Dockerfile 中添加
  RUN apk add --no-cache ttf-dejavu ttf-droid
  （ttf-droid 包含 Droid Sans Fallback，支持简体中文）
• Debian/Ubuntu 镜像：添加
  RUN apt-get update && apt-get install -y fonts-dejavu fonts-wqy-zenhei && rm -rf /var/lib/apt/lists/*
  （fonts-wqy-zenhei 是文泉驿正黑，开源且覆盖全中文）
• 安装后建议执行 fc-cache -fv 刷新字体缓存（尤其 Debian）

确保应用读写与终端解码一致

即使 JVM 编码设对了，若文件读写或日志输出未指定编码，或宿主机终端不支持 UTF-8，仍会乱码：

Java Api Extractor

从 Java 项目中提取 Controller 层接口定义为 JSON 数据。

下载

• 文件操作务必显式传编码：
  new InputStreamReader(new FileInputStream(f), StandardCharsets.UTF_8)
• 日志框架（Logback/Log4j）配置中指定 charset="UTF-8"，例如 Logback 的 下加 UTF-8
• Docker 运行时，可加环境变量确保容器内 locale 正确：
  docker run -e LANG=C.UTF-8 -e LANGUAGE=C.UTF-8 -e LC_ALL=C.UTF-8 ...

快速验证是否修复成功

部署前写个最小测试类，放入容器运行：

• 打印字符串：System.out.println("你好，世界 ✅");
• 用 Graphics2D 绘制中文（模拟报表场景）：g.drawString("测试中文", 10, 20);
• 生成一个含中文名的临时文件，用 cat 查看内容是否正常

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南