8.6 常见错误排查

第 64 节 / 共 81 节 课程:前后端穿透

Nginx 的问题大多能从状态码和日志定位。先看浏览器 Network 的状态码,再看 /var/log/nginx/error.log 的最后几十行,不要一上来就改配置。

现象常见原因排查动作
403 Forbidden目录权限不足、SELinux 拦截、index 文件不存在看 error.log;确认 nobody/nginx 用户可读;临时 setenforce 0 验证
404 Not Foundroot 配错、try_files 没配、文件确实没上传在服务器上 ls 对应路径;curl -I 直连文件
502 Bad GatewaySpring Boot 没启动、端口不对、proxy_pass 指错ss -lntp 看 8080;curl 127.0.0.1:8080;看后端日志
504 Gateway Timeout后端处理超时、数据库慢查询看后端线程栈和慢 SQL;适当调 proxy_read_timeout
413 Request Entity Too Large上传文件超过 client_max_body_size调大该值并同步后端 multipart 限制
499 Client Closed Request客户端提前断开,常见于超时或用户刷新结合后端耗时判断,不要只改 Nginx

几个高频命令:

sudo nginx -t
sudo tail -n 100 /var/log/nginx/error.log
sudo tail -n 100 /var/log/nginx/access.log
curl -I http://127.0.0.1/api/health
ss -lntp | grep -E ':80|:443|:8080'

如果是 502,先在服务器上直接访问后端:curl http://127.0.0.1:8080/api/health。直连通、走 Nginx 不通,问题在代理配置;直连也不通,问题在后端进程或端口。

如果是 404,先确认请求有没有到 Nginx:access.log 里有没有这条记录。没有记录说明 DNS、防火墙或安全组没放行;有记录但 404,才是路径或 root 的问题。

《前后端穿透》课程目录

按教材顺序从 Vue 前端讲到 Spring Boot 后端:模板、组件、路由、axios、Controller、JPA、文件上传、Nginx 部署,最后完成学习平台实训。10 章 71 节,配 220 张操作截图与可直接运行的代码。