Nginx配置踩坑与性能调优

前言

Nginx配置看起来简单，但坑真的多。一个斜杠的差异、location匹配顺序、超时设置不当，都可能导致莫名其妙的问题。

这篇整理Nginx常见的配置错误和性能优化方案，都是生产环境验证过的配置。

一、配置踩坑

1.1 proxy_pass结尾的斜杠

这个坑很常见。

# 前端请求 /api/users # 写法1 location /api { proxy_pass http://backend; } # 后端收到：/api/users # 写法2（多了个斜杠） location /api { proxy_pass http://backend/; } # 后端收到：/users ← /api没了！

就差一个斜杠，效果完全不一样。

简单记：proxy_pass后面带路径（包括单独的/），location匹配的部分会被替换掉；不带路径，原样转发。

1.2 location匹配顺序

location /api { proxy_pass http://backend; } location ~ /api/v[0-9]+ { proxy_pass http://backend-new; }

访问/api/v2/users，你觉得走哪个？

很多人以为按顺序，其实不是。正则匹配~优先于普通前缀匹配。所以走的是第二个。

但如果你想让某个路径不走正则：

location ^~ /api/internal { # ^~ 会阻止后面的正则匹配 proxy_pass http://internal-backend; } location ~ /api { proxy_pass http://backend; }

^~前缀匹配的优先级比正则高。

完整优先级：=精确 >^~前缀 >~正则 > 普通前缀（取最长）

1.3 Vue/React项目刷新404

单页应用部署后，直接访问首页没问题，但刷新或直接访问子路由就404。

location / { root /var/www/dist; try_files $uri $uri/ /index.html; }

这个配置应该没问题，但还是404？

检查这几个：

1、index.html存在吗？

ls-la /var/www/dist/index.html

2、SELinux（CentOS的大坑）

getenforce# 如果是Enforcing# 临时关闭测试setenforce0# 或者正确设置contextchcon -R -t httpd_sys_content_t /var/www/dist

SELinux是CentOS上的常见坑。

1.4 502 Bad Gateway

高并发的时候出现502，后端其实没挂。

通常是upstream的连接数不够了。加上keepalive：

upstream backend { server 127.0.0.1:8080; keepalive 100; # 保持100个空闲连接 } location / { proxy_pass http://backend; proxy_http_version 1.1; proxy_set_header Connection ""; # 这行很重要 }

Connection ""是为了让Nginx用HTTP/1.1的keepalive，不然每次请求都新建连接。

1.5 上传大文件413

413 Request Entity Too Large

Nginx默认只允许1M的请求体：

client_max_body_size 100m;

放在http、server或location块都行。

1.6 WebSocket连接断开

WebSocket连上没多久就断了，通常是超时：

location /ws { proxy_pass http://backend; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade"; # 关键：超时设成长一点 proxy_read_timeout 3600s; proxy_send_timeout 3600s; }

默认60秒没数据就断了，WebSocket要设长一点。

1.7 缓存不生效

location ~* \.(js|css|png)$ { expires 30d; }

配置了但浏览器还是每次都请求？

检查后端有没有返回Cache-Control: no-cache，这会覆盖你的设置。

location ~* \.(js|css|png)$ { proxy_pass http://backend; proxy_ignore_headers Cache-Control Expires; # 忽略后端的 expires 30d; }

二、性能调优

2.1 worker配置

worker_processes auto; # 自动等于CPU核数 events { worker_connections 10240; use epoll; multi_accept on; }

2.2 Gzip压缩

gzip on; gzip_min_length 1k; # 太小的不压缩 gzip_comp_level 5; # 压缩级别，5够用了 gzip_types text/plain text/css application/json application/javascript;

2.3 静态文件缓存

location ~* \.(js|css|png|jpg|gif|ico)$ { expires 1y; access_log off; # 静态文件不记日志，省IO }

2.4 sendfile零拷贝

sendfile on; # 零拷贝 tcp_nopush on; # 合并小包 tcp_nodelay on;

三、配置模板

3.1 反向代理

server { listen 80; server_name api.example.com; location / { proxy_pass http://127.0.0.1:8080; proxy_http_version 1.1; 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_set_header X-Forwarded-Proto $scheme; } }

3.2 前端SPA

server { listen 80; server_name www.example.com; root /var/www/dist; location / { try_files $uri $uri/ /index.html; } location /api { proxy_pass http://127.0.0.1:8080; } location ~* \.(js|css|png|jpg|svg|woff2)$ { expires 1y; } }

四、调试技巧

4.1 检查配置

nginx -t# 语法检查nginx -T# 打印完整配置

4.2 打印变量

不确定变量值是什么的时候：

location /debug { return 200 "uri=$uri\nhost=$host\nargs=$args\n"; }

4.3 查看连接状态

location /status { stub_status on; allow 127.0.0.1; deny all; }

然后curl localhost/status看当前连接数。

总结

Nginx配置常见问题：

性能优化核心：

• 系统层：worker数、连接数、文件描述符
• 传输层：Gzip、sendfile
• 缓存层：静态文件expires、代理缓存
• 连接层：keepalive

有问题评论区交流。