backlog参数控制Swoole服务器全连接队列长度，影响已建立但未被accept的连接缓冲量；默认511，建议中等并发设8192、高并发设16384或更高，但不得超过系统somaxconn值；需通过/proc/sys/net/core/somaxconn查看并调整系统限制，确保应用配置生效。
在使用 Swoole 时，
backlog
参数控制的是服务器监听 socket 的连接等待队列长度。这个值决定了在应用程序尚未处理之前，
操作系统
可以缓冲多少个已建立但未被 accept 的连接请求。合理设置 backlog 对于高并发服务非常重要。
backlog 是什么？
当客户端发起 TCP 连接（SYN），服务端收到后会将连接放入两个队列之一：
半连接队列（SYN Queue）
：存放已完成三次握手前的连接（收到 SYN，还未完成握手）
全连接队列（Accept Queue）
：存放已完成三次握手、等待被应用调用 accept() 取走的连接
backlog 参数主要影响的是
全连接队列的最大长度
。如果队列满了，新的连接请求可能被丢弃或拒绝。
应该设置多大？
建议根据实际业务场景和系统能力来设定。以下是几个关键参考点：
CentOS Linux 7.9.2009
CentOS Linux 7.9.2009是传统CentOS Linux 7的最后主要版本，也是很多企业历史服务器中仍可能遇到的系统版本。它以稳定、兼容RHEL 7生态、文档丰富和软件支持广泛著称，曾长期用于Web服务、数据库、虚拟化节点和企业内部业务系统。不过CentOS Linux 7已于2024年6月30日停止维护，现在继续使用会面临安全补丁缺失风险。该版本更适合旧业务迁移、历史环境恢复或离线兼容性测试。
下载
默认值通常为 511，Swoole 中可通过
$server->set(['backlog' => 8192])
调整
对于中等并发服务（如 API 网关、Web 服务），推荐设置为
8192
高并发场景（如长连接网关、IM 服务），可设为
16384 或更高
最大值受限于操作系统的 somaxconn 内核参数，不能超过该值
如何查看和调整系统限制？
Linux 系统中，backlog 实际生效值受以下参数限制：
—— 查看系统最大允许的 backlog 值
若想设置 backlog 为 16384，需确保 somaxconn ≥ 16384
临时修改：
echo 16384 > /proc/sys/net/core/somaxconn
永久修改：在
/etc/sysctl.conf
中添加
net.core.somaxconn = 16384
，然后执行 sysctl -p
实际配置示例
在 Swoole 服务中设置较大的 backlog：
$server = new Swoole\Server("0.0.0.0", 9501, SWOOLE_PROCESS, SWOOLE_SOCK_TCP);$server->set(['backlog' => 8192,// 其他配置...]);$server->on('connect', function ($server, $fd) { });$server->on('receive', function ($server, $fd, $reactorId, $data) { });$server->start();
基本上就这些。只要系统 somaxconn 足够大，Swoole 的 backlog 设置到 8192～16384 能有效应对大多数高并发接入场景，避免连接丢失。不复杂但容易忽略。
cat /proc/sys/net/core/somaxconn