Nginx重写规则疑问：如何通过查询参数匹配指定HTML文件

嘿，我来帮你搞定这个Nginx重写的问题！你之前的尝试没成功，核心原因是没搞清楚Nginx rewrite 指令的匹配范围——它默认只处理URL的路径部分（也就是?之前的内容），查询参数是单独存在的，不会被包含在rewrite的正则匹配里。

为什么你的旧规则失效？ #

• 第一个规则 rewrite ^/video-detail?videoID=(.*) /$1.html;：正则里的?是特殊字符，表示前面的l可选，所以实际会匹配/video-detai（少一个l）这类路径，而且videoID=xxx属于查询参数，根本不在匹配范围内，自然永远匹配不到。
• 第二个规则虽然用了$arg_videoID这个内置变量，但因为你把规则写在location /里，加上没有正确终止重写流程，导致Nginx没有按预期跳转。

正确的重写方案 #

推荐两种靠谱的写法，选一种适合你的：

方案1：精准匹配路径 + 检查查询参数

这种写法最清晰，也最符合你的需求：

location /video-detail {
    # 当存在videoID查询参数时才执行重写
    if ($arg_videoID) {
        # 重写到对应的html文件，末尾的?是清除原查询参数
        rewrite ^ /$arg_videoID.html? last;
    }
}

• $arg_videoID是Nginx的内置变量，自动提取videoID查询参数的值；
• last指令告诉Nginx重写后重新匹配对应的location规则，确保正确找到目标文件；
• 末尾的?会去掉原URL的查询参数，避免重写后的URL带上多余的?videoID=xxx。

方案2：用rewrite结合条件判断（更简洁）

如果你不想用if，也可以直接用rewrite的条件判断：

rewrite ^/video-detail$ /$arg_videoID.html? last;

这个规则会匹配路径为/video-detail的请求，然后直接用$arg_videoID的值重写，效果和方案1一致。

额外注意事项 #

1. 确保目标文件存在：比如T0r-uCXvDzQ.html必须在Nginx的root配置指定的目录下，如果文件在子目录（比如videos/），要把重写路径改成/videos/$arg_videoID.html；
2. 避免宽泛的location：尽量不要把规则写在location /里，精准匹配/video-detail能减少不必要的规则匹配，提升性能；
3. 测试配置：修改完Nginx配置后，记得用nginx -t检查语法，没问题再重启Nginx生效。

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