Nginx保留UTM参数重定向配置：4种方法彻底解决流量追踪失效问题

为什么UTM参数在Nginx重定向中总是丢失？

很多网站管理员在配置HTTP到HTTPS重定向时，发现Google Analytics的流量来源追踪突然失效了。用户明明是从社交媒体或邮件营销链接过来的，UTM参数却在重定向过程中丢失，导致所有流量都被归为"直接访问"。

这个问题的根源在于Nginx的return指令默认不会自动附加原始请求的查询参数。当你使用return 301 https://$host$request_uri;这样的配置时，如果原始请求的URL包含?utm_source=xxx&utm_medium=xxx，这些参数会被完整保留。但很多管理员错误地使用了return 301 https://$host$uri;，这就导致查询参数全部丢失。

Nginx保留UTM参数的4种配置方法

方法1：使用$request_uri变量（推荐）

$request_uri变量包含了原始请求的URI和所有查询参数。这是最简单的解决方案：

server {
    listen 80;
    server_name youres.cn www.youres.cn;
    
    # 正确：保留所有查询参数，包括UTM
    return 301 https://$host$request_uri;
}

这种配置下，用户访问http://youres.cn/product?utm_source=wechat&utm_medium=social会被正确重定向到https://youres.cn/product?utm_source=wechat&utm_medium=social。

方法2：使用$is_args和$args组合

如果需要更精细的控制，可以显式拼接参数：

server {
    listen 80;
    server_name youres.cn;
    
    # 手动拼接参数
    return 301 https://$host$uri$is_args$args;
}

$is_args变量在存在查询参数时返回"?"，否则返回空字符串。$args包含完整的查询字符串。这种组合确保了参数的正确传递。

方法3：使用rewrite指令

rewrite指令默认会保留原始查询参数：

server {
    listen 80;
    server_name youres.cn;
    
    # rewrite默认保留参数
    rewrite ^(.*)$ https://$host$1 permanent;
}

注意：如果在rewrite的重写目标中使用了"?"，则会清空原有参数。例如rewrite ^(.*)$ https://$host$1? permanent;结尾的"?"会导致参数丢失。

方法4：代理场景下的参数传递

对于使用proxy_pass的场景，需要确保代理请求也携带原始参数：

location / {
    proxy_pass https://backend-server;
    proxy_set_header Host $host;
    # 确保代理请求携带原始参数
    proxy_pass_request_args on;
}

CDN和负载均衡层的额外配置

如果你使用了Cloudflare、阿里云CDN或其他CDN服务，还需要检查CDN层面的配置：

• Cloudflare：在SSL/TLS设置中选择"Full"或"Full (strict)"模式，避免CDN到源服务器的HTTPS跳转导致参数丢失
• 阿里云CDN：检查"回源配置"中的"回源参数设置"，确保选择"保留所有参数"
• 腾讯云CDN：在"缓存配置"中设置"查询字符串"为"全部携带"

验证UTM参数是否被正确保留

使用curl命令验证重定向是否保留了UTM参数：

# 测试重定向是否保留参数
curl -L -v "http://youres.cn/?utm_source=test&utm_medium=article"

# 只查看响应头
curl -I "http://youres.cn/product?utm_campaign=spring_sale"

在Google Analytics的"实时报告"中，你可以立即看到流量来源是否正确追踪。

常见错误配置与修复

性能对比：return vs rewrite

虽然rewrite指令默认保留参数，但在性能上return指令更优。return是Nginx核心模块的指令，执行效率更高；rewrite属于HttpRewriteModule，会引入额外的正则匹配开销。

建议优先使用return 301 https://$host$request_uri;这种配置，既保证了性能，又确保了UTM参数的正确传递。

相关文章推荐

如果你对Nginx重定向和参数处理感兴趣，这些文章也值得一读：

• HTTP跳转HTTPS后Google Analytics参数丢失排查：UTM追踪失效的5个原因与解决方案
• Nginx 301跳转UTM参数丢失？5种解决方案让你的流量追踪数据不再消失
• Nginx $is_args和$args组合用法详解：重定向保留查询参数的正确姿势

正确配置Nginx重定向参数保留，不仅能确保Google Analytics数据准确性，还能提升SEO效果。搜索引擎在抓取页面时，URL中的查询参数也会被考虑在内。如果你的网站有UTM参数丢失的问题，今天就去检查一下Nginx配置吧。