如何在NGINX中配置静态HTML文件的URL路径匹配规则？

问题核心 #

你当前配置遇到的问题：访问/root/level-1这类不带斜杠的URL时，NGINX会自动301重定向到带斜杠的/root/level-1/，而目录下无默认索引文件，导致返回403 Forbidden。根源是NGINX默认会对存在的目录触发斜杠重定向，且你的try_files逻辑中，尝试$uri.html后会继续尝试$uri（即目录），触发了这个重定向机制。

解决方案 #

要实现优先匹配对应路径的.html文件，再处理目录的需求，推荐以下两种配置方式：

方式一：调整try_files逻辑+关闭目录自动索引 #

location ~ ^/root/.*$ {
    # 关闭目录自动索引，避免无默认索引时返回403
    autoindex off;
    # 优先匹配.html文件，再尝试文件本身，最后才尝试目录
    try_files $uri.html $uri $uri/ =404;
    # 若需访问目录时显示默认文件，可添加index指令，例如：
    # index index.html;
}

注意：此方式下，若$uri对应目录存在，NGINX仍会触发斜杠重定向。如果想彻底避免这个重定向，用下面的rewrite方式。

方式二：用rewrite优先匹配.html文件 #

这种方式可以精准控制：当访问不带斜杠的URL时，优先检查对应的.html文件是否存在，存在则直接返回该文件，跳过目录重定向：

location ~ ^/root/.*$ {
    autoindex off;
    # 仅当对应的.html文件存在时，重写URL到该文件
    if (-f $request_filename.html) {
        rewrite ^(.*)$ $1.html break;
    }
    # 尝试文件、目录，无匹配则返回404
    try_files $uri $uri/ =404;
}

或者更简洁的写法（无需检查文件存在，直接尝试重写）：

location ~ ^/root/.*$ {
    autoindex off;
    rewrite ^(.*[^/])$ $1.html break;
    try_files $uri $uri/ =404;
}

验证效果 #

配置完成后，访问/root/level-1会优先返回/root/level-1.html；访问/root/level-1/level-2会优先返回/root/level-1/level-2.html，完全符合你的路径匹配需求。

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