Nginx动态路径autoindex子目录内容返回异常问题排查

核心问题 #

你的配置存在三个关键问题，导致访问子目录或文件时始终返回根目录内容：

1. map变量时机错误：$room_id在location块内定义，但map在Nginx配置加载阶段就会处理，此时$room_id为空，导致map无法正确将short_id映射到full_id。
2. location正则匹配范围有限：原正则~^/(.*?)/(.*)仅匹配包含至少两个斜杠的URL（如/12345/subdirectory），直接访问/12345时不会进入该location，可能触发默认规则返回根目录。
3. alias未处理子路径：即使匹配到子路径，原配置的alias未将请求的子路径追加到实际目录后，所有请求都指向full_id的根目录。

修正后的配置 #

map $short_id $path_name {
    "12345" "12345-ABCD";
    "6789" "disable";
    default "null";
}

server {
    root /disk1/web/root/path;

    # 匹配所有以short_id开头的URL（含根目录和子路径）
    location ~^/([^/]+) {
        set $short_id $1;

        # 拦截无效或禁用的short_id
        if ($path_name = "null") {
            return 404;
        }
        if ($path_name = "disable") {
            return 403;
        }

        # 将根目录切换为full_id对应的实际目录
        root /disk2/path/to/$path_name;
        # 移除URL中的short_id前缀，剩余部分作为实际文件路径
        rewrite ^/[^/]+(.*)$ $1 break;

        # 开启目录索引及相关配置
        autoindex on;
        autoindex_format json;
        addition_types application/json;

        # 添加自定义头尾
        add_before_body /autoindex/header.html;
        add_after_body /autoindex/footer.html;

        add_header Content-Type text/html;
    }
}

配置说明 #

• map修正：将map的键改为$short_id，在location中通过正则捕获URL第一部分赋值给$short_id，确保map能正确映射short_id到full_id。
• location匹配优化：正则~^/([^/]+)匹配所有以short_id开头的URL，无论是否带有子路径。
• 路径映射修正：通过rewrite移除URL中的short_id前缀，再将root设置为full_id对应的目录，请求的剩余路径会直接对应到实际目录的子路径，解决子目录/文件访问问题。
• 保留原有功能：保留了autoindex格式、自定义头尾及Content-Type设置，符合原始需求。

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