【收藏】Nginx运维必备:快速定位错误的实战技巧【保姆级】
一、404 Not Found 错误
问题描述
访问某个 URL 时返回 404 错误，表示请求的资源未找到。
解决方案
- 检查 URL 是否正确
确保输入的 URL 与实际资源路径匹配。 - 确认配置中的 root 或 alias 是否正确
示例配置：
location / {
root /var/www/html; # 确保此路径下有 index.html
index index.html;
}
- 检查文件是否存在
使用命令确认文件是否在指定目录中：
ls /var/www/html/index.html
- 检查 location 块的规则
确保其他 location 配置未导致覆盖。
二、502 Bad Gateway 错误
问题描述
Nginx 作为反向代理时，后端服务不可用或响应错误，导致 502 错误。
解决方案
- 确认后端服务是否运行正常
systemctl status myapp
- 验证 proxy_pass 配置
location /api/ {
proxy_pass http://127.0.0.1:8080; # 确保后端服务运行在该地址
}
- 查看日志
检查 Nginx 日志（/var/log/nginx/error.log）和后端服务日志。 - 检查防火墙
确保防火墙未阻止 Nginx 与后端的通信。
三、403 Forbidden 错误
问题描述
访问资源时，返回 403 错误，表示服务器拒绝访问。
解决方案
- 检查文件权限
确保 Nginx 用户（如 www-data 或 nginx）有读取权限：
chown -R www-data:www-data /var/www/html
chmod -R 755 /var/www/html
- 检查 Nginx 配置的访问控制指令
location /private/ {
deny all; # 检查是否有不必要的拒绝配置
}
- 排查 SELinux 设置
暂时禁用 SELinux 以确认问题：
setenforce 0
四、Nginx 启动失败
问题描述
修改配置后，Nginx 启动失败或无法加载配置。
解决方案
- 验证配置语法
nginx -t
- 查看错误日志
查阅 /var/log/nginx/error.log 以定位问题。 - 检查端口占用
netstat -luntp | grep :80
五、连接超时
问题描述
访问网站时出现连接超时。
解决方案
- 检查网络连接
ping example.com
- 优化超时设置
proxy_read_timeout 60s;
proxy_connect_timeout 60s;
- 优化后端服务性能
确保后端服务能够及时响应请求。
六、SSL/TLS 相关错误
问题描述
配置 HTTPS 时遇到证书错误或握手失败。
解决方案
- 验证证书和私钥路径
ssl_certificate /etc/ssl/certs/example.crt;
ssl_certificate_key /etc/ssl/private/example.key;
- 检查证书有效性
openssl x509 -in /etc/ssl/certs/example.crt -text -noout
- 配置安全协议
ssl_protocols TLSv1.2 TLSv1.3;
七、配置更改无效
问题描述
修改配置后发现更改未生效。
解决方案
- 重新加载配置
nginx -s reload
- 检查修改文件路径
确保在正确的配置文件中进行修改，通常为 /etc/nginx/nginx.conf 或 /etc/nginx/conf.d/ 下的文件。 - 查看错误日志确认是否有相关错误提示。
八、资源占用过高
问题描述
Nginx 的 CPU 或内存占用过高，影响性能。
解决方案
- 优化配置
调整 worker_processes 和 worker_connections的值以匹配硬件性能：
worker_processes auto;
events {
worker_connections 1024;
}
- 分散流量
使用负载均衡方案分散流量，避免单实例过载。
未完待续