Nginx rewrite匹配失效主因是空格及特殊空白字符干扰解析与URI匹配，需从清源（清除配置隐藏符）、控流（前置过滤非法URI）、匹配（规范location与rewrite写法）三方面解决，并通过日志和curl验证。
空格和特殊空白字符（如制表符、全角空格、BOM头、不可见Unicode空格）在 Nginx rewrite 规则中极易引发匹配失效，根本原因不是“正则写错了”，而是配置解析失败或 URI 匹配阶段被干扰。解决重点不在改正则，而在**阻断非法字符进入匹配流程 + 规范路径编码行为 + 主动清理风险片段**。
先清源：避免配置文件本身含非法空白
Nginx 不报“缩进错误”，但混入的隐藏字符会让 rewrite 指令直接不加载或错位执行：
- 用 cat -A nginx.conf 查看所有隐藏符：
^I是 tab，M-oM-;M-?是 BOM，·是不间断空格——这些必须全部清除 - Windows 编辑器保存的 UTF-8 文件常带 BOM，用 dos2unix nginx.conf 一键清理
- 禁止从网页/微信/Word 复制 rewrite 规则；粘贴后立即执行 sed -i 's/[[:space:]]*$//' nginx.conf 删除每行末尾空格
- root 或 alias 路径含空格或中文时，必须加英文引号：root "/var/www/my site";，否则解析中断
再控流：rewrite 前主动拦截非法 URI 片段
浏览器发送的请求中，空格已自动编码为 %20，但双重编码（%252e）、目录遍历（%2e%2e）、空字节（%00）仍可绕过常规规则。应在 rewrite 执行前统一过滤：
- 拒绝非法编码格式：if ($request_uri ~ "%[^0-9A-Fa-f]{2}") { return 400; }
- 阻断目录遍历与空字节：if ($uri ~ "\.\./|%00|%(2e){2}") { return 403; }
- 清理分号干扰（常见于恶意构造）：rewrite ^(/[^;]*)\;.*$ $1 break;
- 所有 rewrite 规则前加这类 if + return 校验，相当于“守门员”，避免后续逻辑被污染
后匹配：location 和 rewrite 中的空格处理要点
URI 中的空格在 Nginx 内部始终以 %20 形式存在，location 匹配也基于这个编码串：
- 想匹配含空格的静态资源（如
style v1.css），实际请求是style%20v1.css，正则应写成：location ~ style%20v1\.css$ { ... } - 避免用正则匹配原始中文或空格名，改用英文符号链接：
ln -s "/var/www/项目文件" /var/www/project，然后只匹配/project/ - rewrite 后若用 last，新 URI 会重新走 location 匹配——确保目标路径也经过同样清理，否则可能落入
location /导致 404
最后验证：用日志确认真实匹配路径
光看配置没用，必须验证运行时行为：
- 开启重写日志：rewrite_log on;（需编译含 debug 日志），查看 error.log 中
test location:字段，确认 rewrite 后 URI 进了哪个 location - 自定义 access_log 记录原始与重写后路径：log_format full '$request_uri → $uri';，访问时一眼看出是否变空或异常
- 用 curl -I 直接看响应头，避开浏览器缓存和自动跳转干扰，验证状态码和 Location 是否符合预期
