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 构造新参数字符串。适用于参数名固定、数量不多的场景：
- 用
if ($args ~* "(^|&)user_id=([^&]*)")捕获旧参数值 - 用
set $new_args "userId=$2";初始化新参数串 - 叠加其他转换：
set $new_args "${new_args}&action=$3";（需先捕获act=xxx） - 最终用
rewrite ^(.*)$ $1?$new_args? break;替换完整 query string
用 map 模块做参数映射（推荐）
更清晰、可维护性高，适合多参数批量映射。需确保编译时启用了 ngx_http_map_module（默认内置）：
- 在
http块中定义映射关系：
map $arg_user_id $std_userId { default ""; "~^(.+)$" $1; } - 同理映射
$arg_act → $std_action、$arg_type_cd → $std_typeCode - 在
location中拼接新参数：
set $proxy_args "userId=$std_userId&action=$std_action&typeCode=$std_typeCode"; - 转发时用
proxy_pass http://backend?$proxy_args;（注意问号触发 query string 替换）
处理 POST 表单或 JSON Body（需模块支持）
若旧参数在请求体中（如 application/x-www-form-urlencoded 或 JSON），Nginx 原生不解析 body，需借助第三方模块：
-
表单参数：使用
nginx-http-form-input-module（需重新编译），启用后可读取$form_user_id并 set 转换 -
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)); } - 无模块时折中方案：前端或网关层提前转换，Nginx 仅做兜底重定向提示
验证与兜底机制
避免因参数缺失或格式异常导致空请求，建议加保护逻辑：
- 用
if ($std_userId = "") { return 400 "Missing required parameter: userId"; } - 开启
rewrite_log on;和error_log /var/log/nginx/rewrite.log notice;跟踪重写行为 - 配置
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"';
