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 参数主要影响的是全连接队列的最大长度。如果队列满了，新的连接请求可能被丢弃或拒绝。
应该设置多大？
建议根据实际业务场景和系统能力来设定。以下是几个关键参考点：
聚彩手机网店系统 免费版
下载
聚彩手机商城系统，是一款专业于手机销售的独立手机网店系统，他拥有众多的手机参数选项，以及傻瓜式的设置选项，让您可以在５分钟内建立起专业而强大的手机销售网站。他拥有多套模版可以实时切换，前台拥有新闻中心、手机中心、配件中心、软件下载、手机报价、发货查询、保修查询、分店查询、产品的对比功能，代理与加盟的申请等功能，他拥有完善的会员中心，会员等级设置等，集成在线支付接口，超强ＳＥＯ，可以设置所有页面的t
- 默认值通常为 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 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 能有效应对大多数高并发接入场景，避免连接丢失。不复杂但容易忽略。
