Nginx

前言：UTM参数消失的罪魁祸首找到了 你在Google Analytics里看到一堆direct流量，百思不得其解：链接明明带了utm_source、utm_medium、utm_campaign，用户点进来的时候也有，怎么就变成direct了？原因很可能就藏在你的重定向链里。 本文从真实故障场景出发，解释清楚：为什么多次重定向会把UTM参数一层层剥掉、怎么快速诊断、以及从哪一层开始根治。 一、先搞清楚：为什么重定向会丢掉参数 1.1 每个跳转都是独立的HTTP请求 重定向不...

问题现象 在 Nginx 配置中，为了让 HTTP 跳转 HTTPS 时保留查询参数（比如 UTM 追踪参数、分页参数 page 等），很多人会用 return 301 https://$host$request_uri; 这样的写法。配置看起来没问题，但跳转后浏览器却报 404，页面找不到。 这个问题在配置看起来"完全正确"的情况下尤其让人困惑。本文把最常见的 5 个原因逐一拆解，帮你快速定位并修复。 原因一：return 301 后面跟的 URL 路径和实际站点目录不匹...

为什么302会导致POST参数丢失？ 这是HTTP协议的历史遗留问题。RFC 7231规定：302响应要求客户端用GET方法访问新地址——也就是说，浏览器收到302后，会主动把POST转为GET，请求体自然就丢了。 很多人以为302只是"临时搬个家"，但实际上它是"搬完家把包裹扔了再过去"。这个问题在表单提交、API调用、支付回调等场景尤为常见，排查起来还很隐蔽——浏览器不会报错，只是后端收到的参数全是空的。 用307/308替代302/301（推荐方案） HTTP/1.1...

在Nginx配置中，问号（?）是一个特殊字符，它在rewrite规则中有着独特的含义。很多开发者在配置重定向时，因为不了解问号的处理机制，导致查询参数莫名消失。本文将深入解析Nginx重定向中问号的自动处理技巧，帮助你彻底搞懂参数保留的底层逻辑。 一、问号在rewrite中的特殊含义 在Nginx的rewrite指令中，问号（?）是一个分隔符，用于区分URI和新的查询字符串。这个设计导致了两种完全不同的行为： 1. rewrite不带问号：自动追加原参数 rewrit...

# Nginx rewrite参数保留4种方法对比：保留、追加、删除、选择性处理实战指南 前言 在Nginx配置中，重定向时查询参数的处理是个老大难问题。很多人配完301跳转，发现UTM参数、分页参数全丢了，流量追踪数据凭空消失。Nginx提供了多种参数保留方式，用错了轻则参数丢失，重则循环重定向。这篇文章把四种主流方法掰开了揉碎了讲，帮你彻底搞懂什么时候该用哪种。 方法一：直接用$request_uri —— 最偷懒的完整保留 这是最简单粗暴的方式，$req...

为什么rewrite会丢失参数？ 配置Nginx rewrite时，很多人遇到一个奇怪问题：重定向后URL里的查询参数（比如 ?utm_source=xxx）不见了。这不是bug，而是Nginx的有意设计。 核心原因：rewrite的替换字符串中一旦出现问号 ?，原请求的查询参数就会被清空。这是最常见的踩坑点。 # 这个规则会把原参数清空！ rewrite ^/old/(.*)$ /new/= last; 明白了原理，下面看4种保留参数的方法。 方法1：用 $is_args...

HSTS preload 的 max-age 要求到底是什么？ HSTS（HTTP Strict Transport Security）preload 是浏览器内置的一个机制，让支持 HTTPS 的网站在用户第一次访问时就能强制走 HTTPS，而不需要先经历一次 HTTP 到 HTTPS 的跳转。 在提交到 hstspreload.org 时，官方对 Strict-Transport-Security 响应头有一个硬性要求： max-age 必须 ≥ 31536000（1年）...

目录 为什么要清空查询参数 方法一：rewrite带问号完全清空 方法二：set清空$args变量 方法三：正则匹配选择性删除指定参数 方法四：map指令按条件过滤参数 4种方法对比总结 常见踩坑 为什么要清空查询参数 查询参数（query string）是URL中问号后面的部分，比如 ?id=123&from=google。在实际运维中，你经常需要把这些参数干掉： 清除追踪参数：UTM参数、fbclid、gclid等营销追踪码，影响缓存命中率 去掉多余参数：...

前言：rewrite、return、proxy_pass 三者混用时的参数迷局 在Nginx配置中，rewrite、return和proxy_pass是最常用的三个指令。单独用的时候大家都明白，但一旦放在同一个location里配合使用，参数传递就经常出问题——查询字符串莫名消失、请求体被丢弃、上游服务收不到参数。 这篇文章从实际配置场景出发，把三者在参数传递上的行为差异讲清楚，让你配Nginx时不再踩坑。 一、三个指令各自怎么处理参数 1. rewrite 的参数处理...

问题说明Nginx rewrite中的问号?会清空原查询参数。原理解析问号是特殊标记，表示截断原有参数。解决方法一用$args变量拼接原参数：rewrite ^/old/(.*)$ /new/?id=$1&$args last;解决方法二用$is_args动态判断：rewrite ^/old/(.*)$ /new/?id=$1$is_args$args last;解决方法三不用问号，改用return 301：return 301 /new/$is_args$args;总结三种...