Nginx重写URL时出现无效变量名错误求助

错误原因 #

你触发的invalid variable name错误，核心是rewrite指令的参数顺序完全颠倒。Nginx的rewrite语法要求：

rewrite <匹配的正则表达式> <替换后的URL> [标志];

你写的rewrite index.php?id=$1 ^id-(.*)$ break;把「替换目标」和「匹配正则」的位置搞反了，Nginx会把index.php?id=$1当作正则表达式解析，此时$1还没有对应的捕获分组，被识别为无效变量，进而抛出错误。

另外，你把这条rewrite放在location = /index.php块里逻辑也不对——这个location仅会匹配精确的/index.php请求，而你要处理的是/id-xxx这类路径，规则根本不会被触发。

修复方案 #

根据你想要实现「将/id-xxx重写为/index.php?id=xxx」的需求，提供两种可行配置：

方案一：在根location中添加规则 #

把rewrite规则放到location /块内，确保所有请求都能被匹配到：

server {
    root /var/www/mypath/2ndpaht/domain/public;
    index index.php index.html index.htm index.nginx-debian.html;
    server_name domain_name.com;

    location / {
        # 先处理id-xxx格式的URL重写
        rewrite ^/id-(.*)$ /index.php?id=$1 break;
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php7.4-fpm.sock;
    }

    location ~ /\.ht {
        deny all;
    }
}

方案二：单独创建匹配location #

专门为/id-xxx路径创建location，逻辑更清晰：

server {
    root /var/www/mypath/2ndpaht/domain/public;
    index index.php index.html index.htm index.nginx-debian.html;
    server_name domain_name.com;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    # 专门匹配/id-xxx格式的请求
    location ~ ^/id-(.*)$ {
        rewrite ^/id-(.*)$ /index.php?id=$1 break;
    }

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php7.4-fpm.sock;
    }

    location ~ /\.ht {
        deny all;
    }
}

验证方法 #

修改配置后，执行以下命令检查配置语法：

nginx -t

如果输出test is successful，再重启Nginx生效：

systemctl restart nginx

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