根目录配置错误是Nginx 404最常见原因，本质是Nginx找不到请求文件；需按序验证：用nginx -T | grep "root"查生效路径，确认该路径下存在对应文件（注意大小写），检查Nginx工作用户权限（如www-data），并严格区分root（路径拼接）与alias（路径替换，末尾必加斜杠）。
根目录配置错误是 Nginx 出现 404 的最常见原因，本质是 Nginx 找不到你请求的文件。排查关键不是“猜”，而是按顺序验证路径是否真实存在、是否被正确指向、是否有权限访问。
确认 Nginx 实际使用的 root 路径
不要依赖印象或文档，直接从运行中的配置里查：
- 运行 nginx -T | grep "root"（大写 T 输出全部生效配置），看 location / 或 server 块里生效的 root 指令值是什么
- 如果用宝塔等面板，注意 Windows 下可能因工作目录偏移（如指向 C:\BtSoft\panel 而非 C:\BtSoft\nginx），导致配置读取错位
- 检查是否在多个配置文件中重复定义 root，后加载的会覆盖前面的
验证该路径下是否存在对应文件
把浏览器请求的 URL 映射成服务器上的物理路径：
- 比如访问 http://example.com/test.html，且配置中 root 是 /var/www/html，那 Nginx 实际查找的是 /var/www/html/test.html
- 用 ls -l /var/www/html/test.html 确认文件存在；若不存在，要么放错位置，要么 URL 写错（大小写敏感！）
- 特别注意：如果 root 后带斜杠（如 root /var/www/html/;）和不带斜杠效果一样，但 alias 后必须带斜杠，混用易出错
检查权限与所有权
文件存在 ≠ Nginx 能读取：
- 运行 ps aux | grep nginx 查看 worker 进程以哪个用户身份运行（通常是 www-data 或 nginx）
- 执行 ls -ld /var/www/html 和 ls -l /var/www/html/index.html，确保目录有执行权限（x）、文件有读权限（r）
- 常见修复：chmod 755 /var/www/html，chmod 644 /var/www/html/index.html，必要时 chown -R www-data:www-data /var/www/html
区分 root 和 alias 的行为差异
这两个指令逻辑不同，误用直接导致 404：
- root 是“拼接”路径：location /static/ { root /data; } → 请求 /static/a.jpg → 查找 /data/static/a.jpg
- alias 是“替换”路径：location /static/ { alias /data/files/; } → 请求 /static/a.jpg → 查找 /data/files/a.jpg
- 切记：alias 末尾必须加斜杠，且不能用于纯目录索引（如 location / { alias /path/; } 是危险写法，应改用 root）
