如何使用.htaccess/mod_rewrite替换多个URL查询参数

你之前使用的单参数替换规则仅适配固定单个参数的修改场景，硬套多参数场景写多条重复规则容易出现参数丢失、符号拼接错误的问题，直接用循环重写逻辑即可实现utm_前缀到mtm_前缀的批量替换，全程保留其他无关参数、参数原有顺序不受影响。

可用规则代码 #

将以下代码放在网站根目录的.htaccess文件中，注意放在其他已有重写规则的最前面：

RewriteEngine On

# 逐次替换查询串里的utm_前缀为mtm_，直到无匹配项为止
RewriteCond %{QUERY_STRING} ^(.*?)utm_([^&]*&?.*)$ [NC]
RewriteRule ^(.*)$ /$1?%1mtm_%2 [N]

# 所有替换完成后触发一次301跳转
RewriteCond %{QUERY_STRING} !utm_ [NC]
RewriteCond %{ENV:REDIRECT_STATUS} ^$
RewriteRule ^(.*)$ /$1 [R=301,L]

规则说明 #

• 核心靠[N]标记实现重写循环：每次匹配到查询串里的第一个utm_前缀就替换为mtm_，重新执行规则集直到查询串里没有剩余的utm_参数，不管参数出现在什么位置、总共有多少个utm开头的参数都能正确处理
• 第二条规则的两个判断条件用来保证仅在所有替换完成后触发一次外部跳转，不会出现多次跳转、参数遗漏的问题
• 如果不需要修改用户浏览器地址栏的显示内容，仅需要服务器内部接收替换后的参数，直接删除第二条规则，在第一条规则末尾加上[L]标记即可
• 如果仅需要对特定路径生效（比如你原规则里的/pokladna/路径），把两条规则里的^(.*)$替换为对应路径匹配规则即可，例如^pokladna/?$

效果验证 #

测试输入URL：https://example.com/?other1=val1&utm_source=source&other2=val2&utm_medium=banner&utm_campaign=campaignname&other3=val3
输出URL：https://example.com/?other1=val1&mtm_source=source&other2=val2&mtm_medium=banner&mtm_campaign=campaignname&other3=val3
夹杂在utm参数前后、中间的其他参数值和位置完全不会被改动。

注意事项 #

上线测试阶段建议先把R=301改成R=302临时跳转，确认所有场景替换逻辑正常后再改回301永久跳转，避免浏览器缓存错误的重写规则。

内容的提问来源于stack exchange，提问作者EscapeNetscape