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 参数主要影响的是全连接队列的最大长度。如果队列满了，新的连接请求可能被丢弃或拒绝。
应该设置多大？
建议根据实际业务场景和系统能力来设定。以下是几个关键参考点：
- 默认值通常为 511，Swoole 中可通过 $server->set([‘backlog’ => 8192]) 调整
- 对于中等并发服务（如 API 网关、Web 服务），推荐设置为 8192
- 高并发场景（如长连接网关、IM 服务），可设为 16384 或更高
- 最大值受限于操作系统的 somaxconn 内核参数，不能超过该值
如何查看和调整系统限制？
linux 系统中，backlog 实际生效值受以下参数限制：
-
cat /proc/sys/net/core/somaxconn—— 查看系统最大允许的 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 SwooleServer(“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 能有效应对大多数高并发接入场景，避免连接丢失。不复杂但容易忽略。