nginx中proxy_pass乱码主因是url编码被错误解码或丢失：默认匹配时解码uri，proxy_pass带路径重写会二次解码，导致中文、%2b等失真；应禁用隐式解码（如decode off）、用proxy_pass http://backend;透传原始$request_uri，并确保后端以utf-8解析。
在 Nginx 中使用 proxy_pass 时出现乱码，多数情况不是编码本身问题，而是 URL 编码未被正确保留或二次解码导致的。Nginx 默认会对 proxy_pass 后的 URI 进行一次解码（尤其在带路径重写时），若后端服务依赖原始编码格式（如含中文、空格、括号、加号等），就容易出错。
确保客户端请求已正确 URL 编码
浏览器或调用方发送含中文、空格等的参数时，必须先做标准 URL 编码（UTF-8 字节 → %XX 形式）。例如：
-
name=张三→ 应发为name=%E5%BC%A0%E4%B8%89 -
q=a+b→ 空格和加号需区分：+在 query 中表示空格，真正要传加号得编码为%2B
如果前端没编码，Nginx 收到非法字节流，后续转发必然混乱。这不是 Nginx 能自动修复的问题，务必从前端源头规范。
避免 location 中的 URI 重写触发额外解码
这是最常见乱码根源。以下写法会引发隐式解码：
location /api/ {
proxy_pass http://backend/;
}
Nginx 会把匹配到的 /api/xxx 中的 /api/ 剪掉，并把 xxx（已解码）拼到 http://backend/ 后 —— 若原始请求中 xxx 含 %E5%BC%A0，它可能被提前解成“张”，再发给后端，而后端又按 UTF-8 解一次，就双解了。
安全做法是：不剪路径，让原始编码完整透传：
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
- 用
proxy_pass http://backend;（末尾无斜杠）+rewrite显式控制（慎用） - 或更推荐：用
location = /api等精确匹配，配合proxy_pass http://backend/api;（保持路径结构一致） - 若必须重写，用
proxy_redirect off;+proxy_set_header X-Original-URI $request_uri;把原始编码串透传给后端参考
关闭 Nginx 对请求 URI 的自动解码（Nginx 1.19.0+）
新版 Nginx 提供 decode 指令可禁用 location 匹配阶段的解码：
location ~ ^/api/[^?]*\? {
proxy_pass http://backend;
proxy_set_header X-Real-URI $request_uri;
}
但更直接的是启用 underscores_in_headers on;（非直接相关，但常配套排查）；真正关键的是：升级到 1.19.0+ 后，在 location 中加 decode 标志：
location /api/ {
proxy_pass http://backend/;
decode off; # ← 关键：禁止 Nginx 自动解码匹配到的 URI 部分
}
注意：decode off 仅影响 location 匹配逻辑，不影响 $uri 变量值；它让 Nginx 把原始编码字符串原样用于 proxy_pass 拼接，从而避免“张三”被解成字节再乱码。
后端服务明确声明接收编码格式
即使 Nginx 转发了正确 %XX 编码，后端若默认用 ISO-8859-1 解 query 或 header，仍会乱。需确认：
- 后端 Web 框架是否设置默认字符集为 UTF-8（如 Spring Boot 的
server.servlet.encoding.charset=UTF-8） - 对
GET参数，检查是否显式调用URLDecoder.decode(param, "UTF-8") - 对
POST表单或 JSON，确认 Content-Type 含;charset=utf-8，且解析逻辑不丢弃编码信息
可在 Nginx 中加日志验证转发内容是否干净：
log_format debug '$remote_addr - $remote_user [$time_local] '
'"$request" $status $body_bytes_sent '
'"$http_referer" "$http_user_agent" '
'req_uri:"$request_uri" uri:"$uri" args:"$args"';
access_log /var/log/nginx/debug.log debug;
对比 $request_uri（原始）和 $uri（已解码），就能定位解码发生在哪一环。
