Swoole 多端口监听必须在 start() 前完成 addlistener，需逐个检查返回值防静默失败；TCP/UDP 协议须匹配对应 socket 类型和事件回调；HTTP 与 WebSocket 应共用 HttpServer 实例而非分开监听；不同端口业务逻辑通过 connection_info($fd)['from_fd'] 关联 listener fd 区分。
多个端口怎么同时监听，addlistener 调用顺序有影响吗
可以，但必须在 start() 之前完成所有 addlistener 调用。Swoole 不允许运行时动态增删监听端口（除非重启进程），调用顺序本身不影响功能，但端口冲突会直接导致 addlistener 返回 false，且不抛异常——容易被忽略。
常见错误现象：只看到主端口启动成功，其他端口没反应，日志也无报错；其实是某个 addlistener 失败后被静默跳过。
- 每个
addlistener必须检查返回值：if (!$server->addlistener(...)) { throw new RuntimeException('listen failed'); } - 避免端口被占用：启动前用
lsof -i :8080或netstat -tuln | grep :8080确认 - 同一 IP + 端口不能重复监听；不同 IP（如
127.0.0.1和0.0.0.0）可共存，但语义不同，别混淆
addlistener 的第二个参数是 SWOOLE_SOCK_TCP 还是 SWOOLE_SOCK_UDP？选错会怎样
取决于你要跑的协议。TCP 是默认、最常用的选择；UDP 需显式指定，且后续必须用 on('packet') 而非 on('receive') 处理数据。选错不会报错，但连接根本建立不起来或收不到数据——因为协议栈不匹配。
使用场景举例：HTTP/HTTPS/自定义 TCP 协议走 SWOOLE_SOCK_TCP；DNS 查询、实时上报、弱网兜底通信才考虑 SWOOLE_SOCK_UDP。
- TCP 监听后，客户端用
telnet或curl能连上；UDP 监听后，telnet必然失败，得用nc -u测试 - UDP 模式下，
$server->send()第二个参数是客户端地址+端口组成的字符串（如'127.0.0.1:12345'），不是 fd - UDP 不保证送达，也不维护连接状态，别拿它传大文件或要求强一致性
HTTP 和 WebSocket 共享一个端口？还是必须分开监听
不能共享。WebSocket 是基于 HTTP 升级协议实现的，Swoole 的 HttpServer 内置了对 Upgrade: websocket 的识别和自动切换，所以只要用 Swoole\Http\Server 启一个端口，就能同时处理 HTTP 请求和 WebSocket 握手及后续帧。
常见错误现象：自己用 addlistener 额外加了个 TCP 端口，又在上面手动解析 WebSocket 协议——纯属重复造轮子，还容易出兼容性问题（比如 Sec-WebSocket-Key 校验失败）。
- 想支持 HTTP + WS，就只启一个
Swoole\Http\Server实例，然后注册on('request')和on('open')/<code>on('message') - 如果需要 HTTP/2 或 HTTPS，必须在
set()中配置ssl_cert_file和ssl_key_file，否则https://或wss://会握手失败 - 别试图在 TCP Server 上复刻 HTTP 解析逻辑——Header 大小、换行符、分块传输等边界情况极多，
HttpServer已经帮你拦好了
监听端口后，如何让不同端口走不同业务逻辑
靠 fd 关联监听端口。Swoole 并不直接暴露“这个连接来自哪个 listener”，但每个 connection 的 $server->connection_info($fd) 返回结果里有 from_fd 字段（注意不是 from_id），它就是该连接所属 listener 的 fd。你得在 addlistener 后立刻记录下各 listener 的 fd。
容易踩的坑：有人误用 from_id，但它只是 worker 内部 ID，跨进程不一致，也不能反查监听配置。
- 初始化时保存 listener fd：
$http_fd = $server->addlistener('0.0.0.0', 9501, SWOOLE_SOCK_TCP); $ws_fd = $server->addlistener('0.0.0.0', 9502, SWOOLE_SOCK_TCP); $listeners = [$http_fd => 'http', $ws_fd => 'ws']; - 在
on('receive')里判断：$info = $server->connection_info($fd); $type = $listeners[$info['from_fd']] ?? 'unknown'; - 注意：UDP 的
on('packet')回调里没有$fd，只有客户端地址，所以 UDP 场景需靠端口区分逻辑，不能依赖from_fd
