容器日志查看乱码通常是因为容器内环境变量 LANG 未设置为 UTF-8。最推荐的处理方向是在 Dockerfile 或 Kubernetes Pod 配置中显式声明 LANG=C.UTF-8，适用场景为 Linux 基础镜像构建及部署，风险边界在于部分极简镜像可能缺少 locale 支持。

命令速用版

如果需要通过命令行快速临时验证，可以在启动容器时传入环境变量。

docker run -it `--rm` -e LANG=C.UTF-8 -e LC_ALL=C.UTF-8 <镜像名> /bin/bash

对于 Kubernetes 临时调试，可以在 pod spec 中加入 env 配置。

env:
  - name: LANG
    value: "C.UTF-8"
  - name: LC_ALL
    value: "C.UTF-8"

为什么会这样

容器日志乱码的根本原因是容器内部默认 locale 设置不支持多字节字符。

大多数 Linux 容器镜像为了减小体积，默认环境变量 LANG 设置为 C 或 POSIX，这两种 locale 仅支持 ASCII 字符。当应用程序输出中文或其他非 ASCII 字符时，字节序列无法被正确解码，导致在 docker logs 或日志收集系统中显示为乱码。此外，如果宿主机终端编码与容器输出编码不一致，也会造成查看时的显示错误。

分步处理

按照构建期配置、运行期配置、应用层配置的顺序进行调整。

步骤 1：检查当前容器 locale 状态

进入容器内部执行 locale 命令，确认当前编码设置。

docker exec -it <容器 ID> locale

如果输出显示 LANG=C 或 LANG=POSIX，则确认为编码配置缺失。

步骤 2：修改 Dockerfile 固化配置

在 Dockerfile 中添加 ENV 指令，确保镜像构建时即包含正确编码。

ENV LANG=C.UTF-8
ENV LC_ALL=C.UTF-8
注意部分精简镜像（如 alpine）可能需要先安装 locale 相关包， Debian/Ubuntu 基础镜像通常默认支持 C.UTF-8。
步骤 3：调整 Kubernetes 部署配置
在 Deployment 或 Pod 的 yaml 文件中，spec.containers.env 字段添加环境变量。
apiVersion: v1
kind: Pod
metadata:
  name: app-log-fix
spec:
  containers:
  - name: app
    image: my-app:latest
    env:
    - name: LANG
      value: "C.UTF-8"
    - name: LC_ALL
      value: "C.UTF-8"
步骤 4：特定语言运行时补充配置
Java 应用可能需要额外参数，Python 应用可能需要设置 PYTHONIOENCODING。
# Java 示例
ENV JAVA_TOOL_OPTIONS="-Dfile.encoding=UTF-8"

# Python 示例
ENV PYTHONIOENCODING=utf-8
怎么验证是否生效
通过容器内命令检查和外部日志查看双重验证。
验证点 1：容器内环境检查
再次执行 docker exec locale，确认 LANG 和 LC_ALL 均显示 C.UTF-8 或 zh_CN.UTF-8。

验证点 2：日志输出检查
触发应用产生一条包含中文的日志，使用 docker logs <容器 ID> 查看，确认无乱码。
验证点 3：持久化日志检查
如果使用了 ELK 或 Loki 等日志系统，检查收集后的日志内容，确保存储端未发生二次转码错误。
常见坑
处理过程中需注意基础镜像差异和语言运行时特性。
Alpine 镜像限制：Alpine Linux 默认可能没有 C.UTF-8，需要安装 glibc 或 musl-locales 包，或者直接改用 Debian Slim 镜像。
Java 应用特殊性：JVM 启动参数 -Dfile.encoding 优先级高于环境变量，需同时配置。
宿主机终端影响：如果本地 SSH 客户端编码不是 UTF-8，即使容器配置正确，本地查看依然会乱码，需检查本地终端设置。
日志收集代理：Filebeat 或 Fluentd 等采集端如果未配置 utf-8 解码，可能在采集阶段就造成乱码，需检查采集配置。
常见问题
Java 容器日志乱码只改 ENV 有用吗？
不一定，Java 应用优先读取 JVM 参数。
建议在 JAVA_TOOL_OPTIONS 环境变量中追加 -Dfile.encoding=UTF-8，确保 JVM 启动时强制指定编码。
Kubernetes 中如何批量修改所有 Pod 编码？
可以通过 Admission Webhook 或修改 Deployment 模板实现。
最稳妥的方式是更新基础镜像 Dockerfile，并在所有 Deployment yaml 的 env 字段中统一添加 LANG 配置。
为什么改了配置日志还是乱码？
可能是日志收集端或查看终端的编码不匹配。
请检查本地终端软件（如 Xshell、Putty）的编码设置是否为 UTF-8，并确认日志存储系统没有进行错误的转码处理。
参考来源
Docker Official Documentation, Dockerfile reference, ENV instruction
Kubernetes Documentation, Pod specification, Environment variables
GNU C Library Documentation, Locale categories