Nginx 如何在 Nginx 中配置将旧版系统的不规范参数名通过重写转换为新版标准

Nginx可通过rewrite+set+proxy_pass或map模块将user_id、act、type_cd等旧参数名自动重写为userId、action、typeCode等标准名，对后端透明；推荐用map模块实现清晰可维护的批量映射，辅以日志验证和兜底校验。

在 Nginx 中将旧版系统不规范的参数名（如 user_id、act、type_cd）自动重写为新版标准参数名（如 userId、action、typeCode），核心不是直接改后端，而是用 rewrite + set + proxy_pass 组合，在请求到达上游服务前完成参数标准化转换。整个过程对后端透明，无需修改应用代码。

提取并重写查询参数

Nginx 本身不支持直接修改 $args 中单个参数，但可通过正则捕获 + set 构造新参数字符串。适用于参数名固定、数量不多的场景：

1. 用 if ($args ~* "(^|&)user_id=([^&]*)") 捕获旧参数值
2. 用 set $new_args "userId=$2"; 初始化新参数串
3. 叠加其他转换：set $new_args "${new_args}&action=$3";（需先捕获 act=xxx）
4. 最终用 rewrite ^(.*)$ $1?$new_args? break; 替换完整 query string

用 map 模块做参数映射（推荐）

更清晰、可维护性高，适合多参数批量映射。需确保编译时启用了 ngx_http_map_module（默认内置）：

1. 在 http 块中定义映射关系：

   map $arg_user_id $std_userId { default ""; "~^(.+)$" $1; }

2. 同理映射 $arg_act → $std_action、$arg_type_cd → $std_typeCode
3. 在 location 中拼接新参数：

   set $proxy_args "userId=$std_userId&action=$std_action&typeCode=$std_typeCode";

4. 转发时用 proxy_pass http://backend?$proxy_args;（注意问号触发 query string 替换）

处理 POST 表单或 JSON Body（需模块支持）

若旧参数在请求体中（如 application/x-www-form-urlencoded 或 JSON），Nginx 原生不解析 body，需借助第三方模块：

1. 表单参数：使用 nginx-http-form-input-module（需重新编译），启用后可读取 $form_user_id 并 set 转换
2. JSON 请求体：推荐用 lua-nginx-module + cjson 解析、改写再透传，例如：

   access_by_lua_block { local args = cjson.decode(ngx.req.get_body_data()); args.userId = args.user_id; ngx.req.set_body_data(cjson.encode(args)); }

3. 无模块时折中方案：前端或网关层提前转换，Nginx 仅做兜底重定向提示

验证与兜底机制

避免因参数缺失或格式异常导致空请求，建议加保护逻辑：

1. 用 if ($std_userId = "") { return 400 "Missing required parameter: userId"; }
2. 开启 rewrite_log on; 和 error_log /var/log/nginx/rewrite.log notice; 跟踪重写行为
3. 配置 log_format 记录原始和转换后参数，用于灰度比对：

   log_format rewrite_log '$remote_addr - $remote_user [$time_local] "$request" $status $body_bytes_sent "$http_referer" "$http_user_agent" "$args" "$new_args"';