Nginx Rewrite功能失效？基础规则配置后返回404问题求助

我来帮你排查这个rewrite失效的坑——我之前调试Nginx规则时也踩过几乎一模一样的雷！

先排查最容易忽略的基础问题 #

首先，你修改配置后有没有重载Nginx？ 这是90%新手会犯的错误：改完配置文件直接刷新浏览器，但Nginx还在运行旧配置。执行以下命令确保配置生效：

sudo nginx -t && sudo nginx -s reload

nginx -t会先检查配置语法是否正确，没问题再用reload重载。

你的正则规则太严格了 #

你写的rewrite ^/a$ /test.html break;是精确匹配/a这个路径——注意是完全不带末尾斜杠、不带任何查询参数的情况。但实际访问时可能出现以下情况导致匹配失败：

1. 浏览器自动给路径加了斜杠（比如输入localhost/a后，浏览器跳转成localhost/a/）
2. 不小心带了查询参数（比如localhost/a?foo=bar）

调整规则的几种方案 #

方案1：放宽正则匹配（兼容带/不带斜杠）

把规则改成兼容末尾斜杠的版本，覆盖更多场景：

location / {
    rewrite ^/a/?$ /test.html break;
}

这里的/?表示末尾的斜杠是可选的，既匹配/a也匹配/a/。

方案2：用精确Location匹配（更高效）

如果只需要匹配/a，直接用精确匹配的Location，比在location /里写rewrite更高效，逻辑也更清晰：

server {
    listen 80 default_server;
    listen [::]:80 default_server;
    server_name _;
    root /var/www/html;

    # 精确匹配/a路径
    location = /a {
        # 内部跳转（地址栏不变，返回test.html内容）
        rewrite ^ /test.html last;
        # 或者用return更高效：return 200 /test.html;
    }

    location / {
        # 其他规则
    }
}

location = /a是Nginx的精确匹配语法，优先级最高，会直接拦截/a的请求。

方案3：忽略查询参数

如果需要匹配带任意查询参数的/a，可以用这个正则：

rewrite ^/a(\?.*)?$ /test.html break;

最后再确认几个细节 #

• 确保/var/www/html/test.html确实存在，且Nginx运行用户（通常是www-data）有读权限：

  ls -l /var/www/html/test.html
  

• 测试时可以用curl直接请求，避免浏览器缓存或自动跳转的干扰：

  curl -v http://localhost/a
  

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