解决docker容器中文乱码需在镜像构建阶段同时配置utf-8编码环境（如env lang=c.utf-8）和注入中文字体（如wqy-microhei），并分别验证locale、fc-list及应用层编码设置。
容器中文乱码不是改一个环境变量就能解决的问题，关键在于镜像构建时就补全底层支持，而不是等容器运行后再临时修补。
镜像层面：从基础开始配齐 UTF-8 环境
乱码的起点在镜像——如果基础镜像没语言环境、没字体，容器启动再怎么设 ENV 也白搭。
- Debian/Ubuntu 类镜像（如 openjdk:17-jre-slim）：必须生成 locale 并设默认值
在 Dockerfile 中加入：RUN apt-get update && apt-get install -y locales && \<br> locale-gen C.UTF-8 && \<br> update-locale LANG=C.UTF-8 LC_ALL=C.UTF-8
再加：ENV LANG=C.UTF-8 LC_ALL=C.UTF-8 - Alpine 镜像（如 openjdk:17-jre-alpine）：musl libc 不自带 locale，需额外安装
RUN apk add --no-cache tzdata musl-locales && \<br> cp /usr/share/locale/C.UTF-8/LC_ALL /etc/locale.conf
同样设：ENV LANG=C.UTF-8 - Java 应用要额外加固：JVM 默认不读系统 locale，启动参数里加上
-Dfile.encoding=UTF-8 -Dsun.jnu.encoding=UTF-8
容器层面：确保字体可用且被识别
有编码没字体 → 显示方块或问号；有字体没编码 → 显示“锟斤拷”或“æ–‡”。两者缺一不可。
- Debian/Ubuntu 容器内装开源中文字体（无版权风险）：
RUN apt-get update && apt-get install -y fonts-wqy-microhei fonts-wqy-zenhei && fc-cache -fv - Alpine 容器需 fontconfig + 字体包：
RUN apk add --no-cache fontconfig ttf-dejavu ttf-droid ttf-freefont && fc-cache -fv - 验证是否生效：
进容器执行fc-list :lang=zh—— 有输出说明字体注册成功；
执行locale—— 确认 LANG 是 UTF-8 值（如 C.UTF-8 或 zh_CN.UTF-8）
应用层面：按需指定编码行为
系统级配置只是基础，具体到应用还要看它怎么用字符集。
- Tomcat：在
catalina.sh启动脚本里加 JVM 参数JAVA_OPTS="$JAVA_OPTS -Dfile.encoding=UTF-8" - Python：代码开头加
import sys; sys.setdefaultencoding('utf-8')（仅 Python 2）；Python 3 默认 UTF-8，但建议显式声明源文件编码：# -*- coding: utf-8 -*- - MySQL 容器：初始化时指定字符集，例如挂载
my.cnf：[mysqld]<br>character-set-server=utf8mb4<br>collation-server=utf8mb4_unicode_ci
快速诊断三步法
遇到乱码别猜，直接进容器跑这三条命令：
-
locale→ 看 LANG 和 LC_ALL 是否为 UTF-8 -
locale -a | grep -i utf→ 看系统有没有生成对应 locale -
fc-list :lang=zh→ 看有没有中文字体返回
三项都 OK，再查应用自身编码设置；任一缺失，就回到对应层级补。
