一、404 Not Found 错误

问题描述
访问某个 URL 时返回 404 错误，表明请求的资源未找到。

解决方案

1. 检查 URL 是否正确
   确保输入的 URL 与实际资源路径匹配。

2. 确认配置中的 root 或 alias 是否正确
   示例配置：

 location / {     root /var/www/html;  # 确保此路径下有 index.html     index index.html;
 }

1. 检查文件是否存在
   使用命令确认文件是否在指定目录中：

 ls /var/www/html/index.html

1. 检查 location 块的规则
   确保其他 location 配置未导致覆盖。

二、502 Bad Gateway 错误

问题描述
Nginx 作为反向代理时，后端服务不可用或响应错误，导致 502 错误。

解决方案

1. 确认后端服务是否运行正常

 systemctl status myapp

1. 验证 proxy_pass 配置

 location /api/ {     proxy_pass http://127.0.0.1:8080;  # 确保后端服务运行在该地址
 }

1. 查看日志
   检查 Nginx 日志（/var/log/nginx/error.log）和后端服务日志。

2. 检查防火墙
   确保防火墙未阻止 Nginx 与后端的通信。

三、403 Forbidden 错误

问题描述
访问资源时，返回 403 错误，表明服务器拒绝访问。

解决方案

1. 检查文件权限
   确保 Nginx 用户（如 www-data 或 nginx）有读取权限：

 chown -R www-data:www-data /var/www/html
 chmod -R 755 /var/www/html

1. 检查 Nginx 配置的访问控制指令

 location /private/ {     deny all;  # 检查是否有不必要的拒绝配置
 }

1. 排查 SELinux 设置
   暂时禁用 SELinux 以确认问题：

 setenforce 0

四、Nginx 启动失败

问题描述
修改配置后，Nginx 启动失败或无法加载配置。

解决方案

1. 验证配置语法

 nginx -t

1. 查看错误日志
   查阅 /var/log/nginx/error.log 以定位问题。

2. 检查端口占用

 netstat -luntp | grep :80

五、连接超时

问题描述
访问网站时出现连接超时。

解决方案

1. 检查网络连接

 ping example.com

1. 优化超时设置

 proxy_read_timeout 60s; proxy_connect_timeout 60s;

1. 优化后端服务性能
   确保后端服务能够及时响应请求。

六、SSL/TLS 相关错误

问题描述
配置 HTTPS 时遇到证书错误或握手失败。

解决方案

1. 验证证书和私钥路径

 ssl_certificate /etc/ssl/certs/example.crt; ssl_certificate_key /etc/ssl/private/example.key;

1. 检查证书有效性

 openssl x509 -in /etc/ssl/certs/example.crt -text -noout

1. 配置安全协议

 ssl_protocols TLSv1.2 TLSv1.3;

七、配置更改无效

问题描述
修改配置后发现更改未生效。

解决方案

1. 重新加载配置

 nginx -s reload

1. 检查修改文件路径
   确保在正确的配置文件中进行修改，一般为 /etc/nginx/nginx.conf 或 /etc/nginx/conf.d/ 下的文件。

2. 查看错误日志确认是否有相关错误提示。

八、资源占用过高

问题描述
Nginx 的 CPU 或内存占用过高，影响性能。

解决方案

1. 优化配置
   调整 worker_processes 和 worker_connections的值以匹配硬件性能：

 worker_processes auto; events {     worker_connections 1024;
 }

1. 分散流量
   使用负载均衡方案分散流量，避免单实例过载。

未完待续