问题几乎都不出在 index 本身，而是它依赖的“请求路径→目录识别→物理定位→文件可读”链路中断；需逐层验证尾斜杠、root/alias 路径拼接、文件权限、proxy_pass 冲突及配置是否真实生效。
index 指令写对了，但访问 / 仍不加载 index.html，问题几乎都不出在 index 本身，而是它依赖的几个关键环节断了。排查要顺着“请求路径 → 目录识别 → 物理定位 → 文件可读”这条链路一层层验证。
检查请求是否以斜杠结尾且被识别为目录
index 只在 URI 以 / 结尾（如 /、/admin/）且对应真实目录时触发。如果访问的是 /admin（无尾斜杠），Nginx 默认不会自动补斜杠，也不会查 index。
- 用
curl -I http://localhost/确认你访问的是带尾斜杠的路径 - 若需自动补斜杠，可在 location 中加
try_files $uri $uri/ =404;，让无斜杠请求先尝试转成目录形式 - 注意：正则表达式 location（如
location ~ ^/api/）默认不触发 index，除非显式重定义
确认 root 或 alias 路径准确指向含 index 文件的目录
index 查找的物理路径 = root（或 alias） + 请求 URI + 索引文件名。路径错一级，就完全找不到。
- 例如
location /app/ { root /var/www; }+ 访问/app/→ 实际查找/var/www/app/index.html - 而
location /app/ { alias /var/www/myapp/; }+ 访问/app/→ 实际查找/var/www/myapp/index.html（不拼接/app） - 用
ls -l /your/root/path/index.html确认文件真实存在，且路径与配置严格一致 - 别漏掉权限：Linux 下目录需有
x权限（才能进入），文件需有r权限（才能读取）
排除代理类指令干扰
只要 location 块里用了 proxy_pass、fastcgi_pass、grpc_pass 等后端转发指令，index 就完全失效——默认页逻辑移交给了后端程序处理。
- 检查该 location 是否混用了
index和proxy_pass；两者不可共存 - 若需前端路由兜底（如 Vue/React SPA），应改用
try_files $uri $uri/ /index.html;，并确保index index.html;仍保留（供$uri/阶段使用） - ThinkPHP、Laravel 等框架也同理：index 要配
index.php，但核心靠try_files $uri $uri/ /index.php?$query_string;
验证配置是否真正加载并生效
写对了不等于起作用。Nginx 可能根本没读到这段配置，或者匹配到了别的 server/location。
- 执行
nginx -t，确认语法正确、路径存在，无 “directory index of … is forbidden” 类报错 - 检查 error_log（如
/var/log/nginx/error.log），设为notice级别，能看到 Nginx 实际尝试读取哪个路径 - 临时删掉系统默认欢迎页（
rm /usr/share/nginx/html/index.html），再访问/：若返回 403，说明你的 root+index 配置压根没被用上 - 确保 server 块有
listen 80;且server_name匹配请求 Host；本地测试可先清空server_name或设为空字符串
