Swoole connect() 返回 false 但无错误信息，需检查 $client->errCode 和 $client->errMsg；异步模式下必须在返回 false 后立即读取；同步模式可加 SWOOLE_SOCK_SYNC 标志；SSL 连接需显式启用并配置证书验证；连接池应避免复用 client 实例，推荐使用协程 socket 或封装组件；网络问题优先排查防火墙、SELinux、安全组及容器网络策略。
connect() 返回 false 但没报错信息
这是最常遇到的“连不上却不知道为啥”的情况。Swoole 的 connect() 默认是异步非阻塞的，调用后立刻返回，失败不会抛异常，也不会在返回值里带错误码——它只返回 false，而真实错误藏在 $client->errCode 和 $client->errMsg 里。
- 必须在
connect()返回false后立刻检查$client->errCode：比如111是 Connection refused，110是 Connection timed out，113是 No route to host - 同步模式下可加
SWOOLE_SOCK_SYNC标志（如new Swoole\Client(SWOOLE_SOCK_TCP | SWOOLE_SOCK_SYNC)），让connect()阻塞并真正失败时才返回，方便调试 - 别依赖
gethostbyname()或手动拼 IP：DNS 解析失败时connect()会静默失败，建议先用getaddrinfo()或dns_get_record()验证域名可达性
SSL 连接卡住或 handshake timeout
用 Swoole\Client 连 HTTPS 服务（如 WSS、TLS API）时，常见现象是 connect() 成功，但后续收不到数据，或触发 onError 报 SSL handshake timed out。
- 必须显式设置
ssl选项：$client->set(['ssl' => true])，否则底层不会走 TLS 握手流程 - 证书验证默认开启，若连的是自签名或内网服务，得关掉：
['ssl_verify_peer' => false, 'ssl_allow_self_signed' => true] - PHP 版本影响大：7.4+ 对 TLS 1.3 支持更稳；低于 7.3 可能因 OpenSSL 版本低导致握手失败，建议用
openssl version -a核对 - 别在连接后立刻
send()：TLS 握手是异步完成的，要等onConnect触发后再发数据，否则可能被服务器断连
连接池复用导致 errno=9 (Bad file descriptor)
多人共用一个 Swoole\Client 实例、或在协程里反复 close() + connect() 后再用，容易触发 errno=9 错误——本质是 fd 被释放了还去读写。
-
Swoole\Client不是线程/协程安全的，单实例不能跨协程复用；每个协程应创建独立 client 实例 - 手动
close()后不要再调send()或recv()，也没必要主动 close：协程结束时 client 会自动释放 - 想做连接池？别自己维护 fd：用
Swoole\Coroutine\Socket+connect()更轻量，或者上hyperf/socket-client这类封装好的池化组件 - 注意
SOCKET类型差异：TCP 和 UDP client 复用逻辑不同，UDP 没有连接状态，connect()只是绑定远端地址，别当成 TCP 那样管理
防火墙 / SELinux 导致 connect() 通但 recv() 无响应
本地测试连通，一上生产就卡住，strace 看到 recvfrom() 一直阻塞，netstat 显示 ESTABLISHED，但就是没数据回来。
- 检查目标端口是否真开放：
telnet $host $port或nc -zv $host $port，别只信 ping - 云服务器注意安全组规则：入方向（Inbound）放行目标端口，出方向（Outbound）也要检查是否限制了源端口范围（某些厂商默认只放行 1024–65535）
- SELinux 启用时（尤其 CentOS/RHEL），即使端口开着，也可能拦截 PHP 进程的网络行为，临时关闭验证：
setenforce 0 - 容器环境重点查宿主机 iptables 和 pod 网络策略（NetworkPolicy），
iptables -L -n -t nat看是否有 SNAT/DNAT 干扰
实际排障时，errCode 和 strace 比日志更可靠；很多“连不上”问题，根源不在 Swoole 本身，而在系统网络栈那一层没暴露出来。
