Swoole中TCP服务器与UDP服务器的配置区别

先说几个关键点，Swoole里UDP和TCP服务器的差别其实比很多人想象的要大。用错配置、写错事件、甚至发送方式的差异，都可能让一个看起来能用的服务，在实际运行时悄无声息地“失灵”。

如果您写过TCP的Swoole服务，再切到UDP时，容易习惯性地沿用老思路——而这条路，恰恰是坑最多的地方。下面我们来拆开细看。

UDP服务器必须显式指定 SWOOLE_SOCK_UDP 类型

不写或写错类型，SwooleServer 默认创建的是 TCP 服务器。哪怕端口监听成功，客户端用 UDP 发包也收不到——因为底层协议栈根本没打开 UDP 套接字。

正确写法是：

$server = new SwooleServer('127.0.0.1', 9502, SWOOLE_PROCESS, SWOOLE_SOCK_UDP);

常见错误包括：

• 漏掉第四个参数，误用 new SwooleServer('127.0.0.1', 9502) —— 这仍是 TCP
• 传入字符串如 "udp" 或数字 2，而非常量 SWOOLE_SOCK_UDP
• 在协程风格中混用 SwooleHttpServer 或 SwooleWebSocketServer，它们不支持 UDP

TCP 的 onConnect/onClose 事件在 UDP 中完全不存在

UDP 是无连接协议，没有“建立连接”和“断开连接”的概念，所以 onConnect、onClose 回调注册了也不会触发。强行注册只会浪费资源，还可能误导逻辑判断。

UDP 唯一的数据入口是 onPacket，它接收三个参数：$server、$data、$client_info（含 address 和 port）。你必须靠 $client_info 自行识别来源，不能依赖 $fd（该变量在 UDP 中无效）。

典型误用：

• 在 UDP server 中写 $server->on('Connect', ...) 并期待日志输出
• 试图调用 $server->close($fd) —— UDP 不支持关闭单个客户端会话
• 把 TCP 的 $fd 当作客户端标识缓存，结果发现每次 onPacket 的 $fd 都是 0 或随机值

set() 配置项对 TCP 和 UDP 的生效逻辑不同

部分配置项只对 TCP 有意义，Swoole 不会报错，但实际不生效。例如：

• heartbeat_idle_time 和 heartbeat_check_interval：仅作用于 TCP 连接，UDP 无心跳机制
• open_tcp_nodelay：TCP 专用选项，UDP 不涉及 Nagle 算法
• open_eof_split、package_max_length：这些是为解决 TCP 粘包设计的，UDP 天然按报文边界收发，设了也无效

但以下配置项两者都可用：

• worker_num：影响处理并发 packet 的能力
• daemonize、log_file：进程与日志控制通用
• dispatch_mode：UDP 同样支持按 IP/PORT 哈希分发（mode=4），避免单 worker 过载

客户端发送方式根本不同：TCP 要 connect()，UDP 直接 sendto()

TCP 客户端必须先调用 $client->connect() 建立连接，之后才能 send()/recv()；而 UDP 客户端压根不需要 connect，直接 sendto($ip, $port, $data) 即可。

如果你用 TCP 客户端代码去连 UDP 服务端（或反过来），会出现：

• TCP client 调 connect() 到 UDP 端口 → 返回 Connection refused（系统层拒绝）
• UDP client 调 send()（非 sendto）→ 报错 Operation not supported
• UDP client 忘记传 $port 给 sendto() → 数据发到 0 端口，服务端收不到

务必核对客户端构造时的协议类型：

$tcp_client = new SwooleClient(SWOOLE_SOCK_TCP); // 必须 connect$udp_client = new SwooleClient(SWOOLE_SOCK_UDP); // 用 sendto，不 connect

最易被忽略的一点：UDP 没有连接状态，也就没有“连接超时”“重连”“连接池”这些概念。所有可靠性保障（比如重传、应答、顺序）都得你自己在应用层实现，Swoole 不介入。