核心是确保中文请求头在客户端→Nginx→后端全链路保持UTF-8字节原样透传：客户端须URL编码为%E6%B5%8B等格式，Nginx禁用underscores_in_headers并避免变量拼接，后端必须显式用UTF-8解码原始字节，且环境locale设为UTF-8。
排查 Nginx 请求头转发中中文参数乱码，核心是确认“中文字符从客户端发出 → 经 Nginx 透传 → 到达后端”整个链路的字节是否始终为 UTF-8 编码且未被意外解码、重编码或丢弃。不是 Nginx “不支持中文”，而是字节在某个环节被错误解释。
第一步：确认客户端发送的是合法 UTF-8 编码
浏览器不会在请求头里直接发裸中文（如 X-User: 张三），这是非法 HTTP 行为。真实情况是：客户端必须先将中文按 UTF-8 编码为字节，再做 URL 编码（如 %E5%BC%A0%E4%B8%89）或 Base64 等方式封装。常见错误源头：
- 用
curl -H "X-User: 张三" ...测试时，curl 默认按系统 locale 编码（如 Linux 是 UTF-8，Windows CMD 常是 GBK），导致发送的是 GBK 字节，Nginx 收到后原样透传，后端按 UTF-8 解就乱码 - Postman 或脚本手动构造 header 时未做 UTF-8 + URL 编码，直接填入中文字符串
- 前端 JS 使用
fetch发送 header，但未对中文值做encodeURIComponent
✅ 正确验证方式：curl -v -H "X-Test: $(printf '测试' | iconv -f utf-8 -t utf-8 | xxd -p | tr -d '\n' | sed 's/../%&/g')" http://your.nginx/，或更简单地用已知 UTF-8 编码值：curl -v -H "X-Test: %E6%B5%8B%E8%AF%95" http://your.nginx/
第二步：检查 Nginx 是否静默丢弃或破坏 header
Nginx 默认会丢弃含下划线（_）的请求头字段（如 X-用户-ID），且不报错、不记录——这常被误判为“没转发”。此外，某些配置会隐式修改 header：
- 确认是否启用了
underscores_in_headers on;（只能放在http或server块顶层，不能在location内） - 避免在
proxy_set_header中拼接变量，例如proxy_set_header X-Trace "$host $remote_addr";—— 若变量值含非 ASCII 字符，可能触发异常 - 禁用可能干扰 header 的模块，如
ngx_http_sub_module、第三方 WAF 模块，它们有时会对 header 做正则替换
✅ 快速验证：在 Nginx 配置中临时添加日志记录该 header：log_format debuglog '$remote_addr - $remote_user [$time_local] "$request" $status $body_bytes_sent "$http_x_test"';，再查 access_log 看原始值是否完整到达。
第三步：验证后端是否按原始字节 + UTF-8 解码
Nginx 只负责透传二进制字节，不解析 header 内容。乱码绝大多数发生在后端错误地使用平台默认编码（如 Java 的 System.getProperty("file.encoding")）去解码接收到的字节流。
- Java：不要用
request.getHeader("X-User")，改用getRawHeader()（Servlet 6.0+）或从原始 socket input stream 读取字节，再用new String(bytes, StandardCharsets.UTF_8) - Node.js：Express 的
req.get("X-User")通常已正确，但需确认未启用querystring模块对 header 做额外处理 - PHP：
$_SERVER['HTTP_X_USER']是原始字符串，但 FastCGI 下要检查fastcgi_param HTTP_X_USER $http_x_user是否被覆盖或截断
✅ 调试技巧：在后端打印接收到的 header 字节十六进制值（如 Python：bytes(header_value, 'latin-1').hex()），对照 测试 的标准 UTF-8 字节 e6b58be8af95 判断是否一致。
第四步：检查运行环境底层编码设置
即使代码逻辑正确，若容器或宿主机 locale 不是 UTF-8，也可能导致子进程、日志、甚至某些语言 runtime 的默认编码出错：
- Docker 镜像中检查：
locale输出应含LANG=zh_CN.UTF-8或en_US.UTF-8；缺失则在 Dockerfile 中加ENV LANG=C.UTF-8 - WSL 或 Linux 主机：执行
echo $LANG，若不是 UTF-8，临时修复：export LANG=en_US.UTF-8；永久生效可写入/etc/default/locale - 避免在 Windows CMD 或 PowerShell（非 UTF-8 模式）下启动 Nginx 或调试脚本，尤其涉及文件路径或日志查看时
不复杂但容易忽略。
