index指令在location块中优先级最高，需路径以斜杠结尾且配合root/alias；不生效常见原因包括无尾斜杠、目录不存在、权限不足、大小写错误或存在proxy_pass等代理指令。
直接在 location 块里写 index 指令，就能覆盖上级（server 或 http）的默认首页设置。它的生效逻辑很简单：Nginx 会用离请求路径最近的那个 index 配置，优先级是 location > server > http。
怎么写才有效
确保 index 指令放在目标 location 块内部，并且路径以斜杠结尾（如 /admin/）、对应真实目录，才会触发查找：
-
location / { index login.html index.html; }→ 访问/时先找login.html -
location /blog/ { index index.php; }→ 访问/blog/时只查index.php，不试其他文件 -
location /static/ { index ""; }→ 禁用该路径的默认页功能，必须显式写/static/file.txt才能访问
注意 root 或 alias 的配合
index 查找的物理路径，由 root 或 alias 和请求 URI 共同决定：
-
location /app/ { root /var/www; index index.php; }→ 实际检查/var/www/app/index.php -
location /app/ { alias /opt/myapp/; index index.html; }→ 实际检查/opt/myapp/index.html（注意：alias不拼接 URI 路径）
常见不生效的原因
即使写了 index，也可能没反应，重点排查这几项：
- 请求地址没带尾部斜杠（如
/admin），Nginx 不当它是目录，index不触发；可加try_files $uri $uri/ =404;补救 - 对应目录不存在，或 Nginx 进程无读取权限（Linux 下目录需有
x权限才能进入） - 指定的文件名大小写错误（例如配置了
index.html，但实际是Index.html） - 该
location块里用了proxy_pass或fastcgi_pass，此时index完全不生效——默认页应由后端程序处理
搭配 try_files 更灵活
单纯靠 index 只能服务静态目录首页；若要支持单页应用（SPA）或兜底到某个固定入口，建议组合 try_files：
-
location / { index index.html; try_files $uri $uri/ /index.html; }→ 先按常规规则找资源，找不到就回退到index.html，让前端路由接管 - 这种写法比仅靠
index更健壮，尤其适合 Vue、React 项目
