Nginx 中 index 与 autoindex 不能直接配合实现“有首页则显示、无则列目录”；需用 try_files $uri $uri/ =404 配合 index 和 autoindex 才能模拟该逻辑。

在 Nginx 中，index 和 autoindex 是两个独立但常被混淆的功能：前者用于指定默认首页文件，后者用于开启目录列表（即“索引页”）。它们**不能直接配合使用来实现“优先找 index 文件，找不到再列目录”**——这是常见误解。Nginx 的处理逻辑是：先尝试匹配 index 指令定义的文件；若全部不存在且请求路径是目录，才可能触发 autoindex on（前提是未命中任何 index 文件、无重定向、且 location 配置允许）。

index 指令：定义默认首页文件

index 用于当用户访问一个目录路径（如 / 或 /static/）时，Nginx 自动查找并返回指定名称的文件。它只影响“文件是否存在”的判断，不控制目录是否可浏览。

• 语法示例：index index.html index.htm;
• 查找顺序从左到右，找到第一个存在的文件即返回（状态码 200）
• 如果所有指定文件都不存在，Nginx 默认返回 403（禁止访问）或 404（取决于是否有其他匹配规则），不会自动启用 autoindex
• 该指令需放在 location 块中才生效，例如：
    location /files/ {
      root /var/www;
      index index.html;
    }

autoindex 指令：开启目录列表功能

autoindex on 会让 Nginx 在请求一个真实存在的目录、且未成功匹配任何 index 文件时，生成并返回该目录下的文件列表（类似 FTP 目录视图）。它与 index 是互斥路径分支，不是协同流程。

• 必须确保目录存在且 Nginx 有读取权限，否则返回 403
• 需显式关闭 index 匹配，或确保 index 文件不存在，autoindex 才有机会生效
• 常用搭配：
    location /downloads/ {
      alias /data/public/;
      autoindex on;
      autoindex_format html;
      autoindex_exact_size off;
      autoindex_localtime on;
    }
• 注意：autoindex 不支持 root + 路径拼接方式用于子目录索引，推荐用 alias 明确映射

如何实现“有 index 就显示，没有就列目录”？

这不是 Nginx 原生支持的“fallback”行为，但可通过配置逻辑模拟：

• 方案一（推荐）：用 try_files 实现显式回退
    location /shared/ {
      alias /var/www/shared/;
      try_files $uri $uri/ =404;
      # 注意：$uri/ 会触发内部重写为目录路径，此时若无 index 文件，且 autoindex 开启，才生效
      index index.html;
      autoindex on;
    }
  关键点：Nginx 对 $uri/ 的处理会进入目录匹配阶段，此时 index 和 autoindex 才按顺序起作用。
• 方案二：分离 location，用 error_page 间接跳转
  先配一个带 index 的 location，403/404 时用 error_page 403 /_list 跳转到另一个仅开启 autoindex 的 location —— 但实际体验差，不推荐

常见陷阱与注意事项

• autoindex 只对真实目录生效，符号链接需开启 disable_symlinks off;（慎用）
• 开启 autoindex 存在安全风险，切勿在生产环境对敏感路径启用
• index 后面的文件名不支持通配符或正则，只能是具体文件名列表
• 若同时使用 root 和 alias，注意路径拼接差异：root 是前缀追加，alias 是完全替换
• 调试技巧：开启 error_log /var/log/nginx/error.log debug; 查看 Nginx 如何解析请求路径和匹配 index 文件