Nginx 常见问题总结与解决
1. 配置错误
现象：Nginx无法启动/重载。
原因：语法错误、路径错误。
解决 ：
检查语法：nginx -t
查看错误日志：tail -f /var/log/nginx/error.log
路径问题 ：区分root与alias：
nginx
复制代码
location /static/ {
alias /data/www/static/; # 请求/static/img.png → /data/www/static/img.png
}
location /assets/ {
root /data/www/; # 请求/assets/img.png → /data/www/assets/img.png
}
2. 性能优化
现象：高并发下连接超限或响应慢。
解决 ：
调整nginx.conf参数：
nginx
复制代码
worker_processes auto; # 与CPU核心数一致
events {
worker_connections 10240; # 单进程最大连接数
}
http {
keepalive_timeout 65;
keepalive_requests 1000;
}
修改系统文件描述符限制：
bash
复制代码
ulimit -n 65535 # 临时生效
# 永久生效：编辑/etc/security/limits.conf，添加：
# * soft nofile 65535
# * hard nofile 65535
3. 权限问题
现象：403 Forbidden。
解决 ：
检查文件权限：
bash
复制代码
chmod -R 755 /data/www;
chown -R www-data:www-data /data/www;
禁用SELinux（临时）：
bash
复制代码
setenforce 0 # 或修改/etc/selinux/config永久关闭
4. SSL证书问题
现象：浏览器提示证书错误。
解决 ：
确保证书链完整（合并中间证书）：
bash
复制代码
cat domain.crt intermediate.crt > fullchain.crt
配置SSL协议与加密套件：
nginx
复制代码
ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256;
5. 反向代理问题
现象：后端无法获取真实IP或超时。
解决 ：
传递必要请求头：
nginx
复制代码
location / {
proxy_pass http://backend;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_connect_timeout 60s;
proxy_read_timeout 60s;
}
6. 负载均衡配置
现象：后端服务宕机未剔除。
解决 ：
配置健康检查：
nginx
复制代码
upstream backend {
server 10.0.0.1:80 max_fails=3 fail_timeout=30s;
server 10.0.0.2:80;
least_conn; # 可选策略：轮询（默认）、weight、ip_hash等
}
7. 静态文件服务
现象：静态资源404或SPA路由失效。
解决 ：
使用try_files处理前端路由：
nginx
复制代码
location / {
root /data/www;
try_files $uri $uri/ /index.html;
}
8. 重写规则
现象：重定向循环或URL未生效。
解决 ：
HTTP强制跳转HTTPS：
nginx
复制代码
server {
listen 80;
server_name example.com;
return 301 https://$host$request_uri;
}
9. 跨域问题（CORS）
现象：前端请求跨域被拦截。
解决 ：
添加响应头：
nginx
复制代码
location /api/ {
add_header 'Access-Control-Allow-Origin' '*';
add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS';
}
10. WebSocket支持
现象：WebSocket连接失败。
解决 ：
配置代理头：
nginx
复制代码
location /ws/ {
proxy_pass http://backend;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
}
11. 安全加固
现象：服务器信息泄露。
解决 ：
隐藏Nginx版本：
nginx
复制代码
server_tokens off;
添加安全头：
nginx
复制代码
add_header X-Frame-Options DENY;
add_header X-Content-Type-Options nosniff;
12. 日志管理
现象：日志文件过大。
解决 ：
使用logrotate配置轮转：
bash
复制代码
# /etc/logrotate.d/nginx
/var/log/nginx/*.log {
daily
rotate 30
compress
missingok
notifempty
sharedscripts
postrotate
/usr/sbin/nginx -s reload
endscript
}
总结
遇到问题时，优先检查错误日志（error.log），结合nginx -t验证配置。复杂场景可通过分阶段调试（如逐步添加规则）定位问题根源。