Nginx连接数增多时出现504网关超时错误的解决方法

1. 排查后端邮件服务的连接承载能力 #

• 检查后端邮件服务（如Postfix、Dovecot）的并发连接限制，比如Postfix的smtpd_recipient_limit、default_process_limit，Dovecot的service imap-login { process_limit = ... }，根据实际负载调高合理值，确保后端能承接Nginx转发的请求量。
• 查看后端服务的日志，确认是否存在自身的连接拒绝、资源耗尽或超时记录，排除后端服务的瓶颈。

2. 优化Nginx上游连接与超时配置 #

修改Nginx配置文件，针对性调整上游和代理参数：

• 开启上游连接复用：在upstream块中添加keepalive参数，减少频繁新建连接的开销：

upstream mail_backend {
    server 127.0.0.1:25; # 替换为你的后端邮件服务地址
    keepalive 1000; # 保持1000个长连接，可根据实际调整
}

• 调整代理超时时间：在server或location块中设置合理的超时阈值，避免因上游响应慢触发504：

proxy_connect_timeout 30s;
proxy_send_timeout 60s;
proxy_read_timeout 60s;
proxy_next_upstream error timeout; # 上游出错/超时后尝试其他节点（多上游场景）

• 调高Worker连接处理能力：在events块中优化连接数和事件模型：

events {
    worker_processes auto; # 自动匹配CPU核心数
    worker_connections 4096; # 单worker最大连接数，可根据服务器配置调高
    use epoll; # Linux下推荐用epoll提升高并发效率
    multi_accept on; # 允许worker一次性接收所有新连接
}

3. 优化系统TCP网络参数 #

修改/etc/sysctl.conf调整系统网络栈，支持更多并发连接：

# 复用TIME_WAIT状态的连接
net.ipv4.tcp_tw_reuse = 1
# 取消TCP连接回收（避免NAT场景问题）
net.ipv4.tcp_tw_recycle = 0
# 调整TCP内存分配阈值
net.ipv4.tcp_mem = 94500000 915000000 927000000
# 调高系统最大文件描述符数
fs.file-max = 1000000

执行sysctl -p使配置生效，同时在Nginx配置开头添加文件描述符限制：

worker_rlimit_nofile 1000000;

4. 适配邮件协议的Nginx代理配置 #

如果是Nginx做SMTP/IMAP代理，确保配置符合邮件协议要求：

• SMTP代理示例：

server {
    listen 25;
    smtp_pass mail_backend;
    smtp_timeout 60s; # 调整SMTP会话超时时间
}

• 避免在邮件代理链路中添加不必要的缓存、过滤规则，减少额外处理延迟。

5. 启用Nginx状态监控排查 #

配置状态页面实时查看连接指标，定位问题：

server {
    listen 8080;
    location /nginx_status {
        stub_status on;
        allow 127.0.0.1; # 限制仅本地访问
        deny all;
    }
}

访问http://localhost:8080/nginx_status可以查看活跃连接数、上游连接状态等数据，确认是否是连接数耗尽导致的问题。

内容的提问来源于stack exchange，提问作者hamza toor