Nginx 403、404 典型故障排查方法

Nginx 403、404 典型故障排查方法
一、404 Not Found 资源未找到
核心含义：服务器成功收到请求，但找不到对应磁盘文件。

分步排查顺序

1. 核对URL拼写：域名、文件夹名、文件名、后缀是否写错（如demo.png写成demo.img、localhost写成loaclhost）
2. 核对root/alias路径映射规则：
   root：本地路径=root目录 + URL完整路径，检查拼接路径是否真实存在
   alias：映射文件夹末尾缺少/，访问目录会路径错乱404
3. 检查location匹配优先级：多条location冲突，匹配到空白规则
4. 校验文件是否真实存在，使用ls 完整磁盘路径确认文件未删除
   高频报错场景
   alias未加斜杠，仅访问目录时404
   URL文件名后缀和服务器本地文件不一致
   location前缀配置错误，无法匹配资源目录
   二、403 Forbidden 权限拒绝访问
   核心含义：目标文件真实存在，但Nginx进程没有进入/读取文件夹的权限。

分步排查顺序

1. 文件夹缺少x执行权限（最常见）
   nginx运行用户www-data属于其他用户，目录必须带x权限才能进入。修复命令：

chmod 755 /home/ubuntu
chmod 755 /home/ubuntu/mywebsite

2. 上级目录权限不足：即便站点文件正常，父目录权限700也会拦截访问
3. 访问网站根路径但无index.html，Nginx默认禁止列出目录，返回403
4. 区分：防火墙、云安全组不会返回403，只会出现连接超时
   高频报错场景
   用户家目录默认权限限制，未执行755赋权
   站点文件夹权限设置为700，禁止其他用户访问
   根路径无index首页文件，无目录浏览权限
   三、快速区分记忆

404：路径映射错误、文件名拼写错误、资源文件不存在
403：文件存在，但Nginx无权限进入文件夹读取内容