Workerman 4 默认不处理 DNS 解析异步化,所有同步域名解析(如 fsockopen、cURL、GuzzleHttp)均触发阻塞式 getaddrinfo(),卡住事件循环;其基于 ReactPHP 构建,仅接管 I/O 多路复用,不接管 DNS 解析环节。

Workerman 4 默认不处理 DNS 解析的异步化,所有基于 PHP 原生 fsockopen、cURL 或 GuzzleHttp 同步调用的域名解析,都会触发阻塞式 getaddrinfo(),直接卡住当前 Worker 进程的事件循环 —— 即便你用的是异步 HTTP 客户端,只要底层没绕过系统 DNS 调用,就仍可能在连接建立前“挂住”。
为什么 Workerman 本身不解决 DNS 阻塞
Workerman 是基于 ReactPHP 事件循环(Worker::$globalEvent)构建的,它只接管 I/O 多路复用和 socket 读写,但不接管域名解析环节。PHP 的 gethostbyname()、dns_get_record()、甚至 cURL 的 CURLOPT_RESOLVE 之外的自动解析,全走操作系统同步路径。这意味着:哪怕你用 GuzzleHttp\Client 配了 React Handler,只要没显式预解析或禁用自动解析,getAsync() 内部仍会在 connect 阶段同步查 DNS。
可行的替换方案:预解析 + 缓存 + 强制 IP 直连
Workerman 场景下最稳定、零依赖、无需额外扩展的解法,是把 DNS 解析从请求链路中剥离出来,提前做、缓存住、后续直连 IP。这不是“让 DNS 变异步”,而是“让 DNS 不出现在异步路径里”。
-
启动时批量预解析关键域名:在
onWorkerStart中用dns_get_record($host, DNS_A)或gethostbyname()获取 IP,并存入全局数组或 Swoole\Table;对失败域名可设默认 fallback 或标记重试 -
请求时用 IP 替代域名构造 URL:比如原要请求
https://api.example.com/v1,改用https://192.0.2.1/v1,同时手动设置Host: api.example.com请求头(否则后端可能路由失败) - 搭配 TTL 缓存机制:记录每个域名解析结果的获取时间与权威 DNS 返回的 TTL,定期轮询刷新;避免用永久缓存导致 IP 变更后长期不可用
进阶方案:集成第三方异步 DNS 封装
若必须动态解析大量未知域名(如反向代理场景),可引入轻量级封装,例如:
- 使用
react/dns:它基于 UDP socket 自行构造 DNS 查询包,完全不调用getaddrinfo(),配合 React 事件循环运行;需将Worker::$globalEvent传给其ResolverFactory - 封装
dns_get_record()为 Promise(配合amphp/amp):虽仍是同步函数,但可通过call_user_func_array+pcntl_fork或exec('dig +short')方式外包解析,再通过 pipe 回传结果(仅限 CLI 环境且需权限控制) - 禁用 PHP 自动解析,全部走自定义 resolver:GuzzleHttp 支持
curl.resolver选项,可注入返回 IP 的闭包,绕过底层 DNS 调用
避坑提醒:别踩这些常见错误
很多团队尝试“用多线程模拟异步 DNS”,结果反而更慢甚至崩溃:
- 在 Worker 进程内
pcntl_fork做解析 → 子进程退出后资源未清理,长期运行导致句柄泄漏 - 用
shell_exec('nslookup ...')→ 每次启动新进程开销大,高并发下 fork 爆炸,CPU 直接拉满 - 误以为
dns_get_record()是异步的 → 它是纯同步阻塞函数,只是比gethostbyname()支持更多记录类型 - 未重写 Host 头就直连 IP → 后端 Nginx / Apache 因
server_name匹配失败返回 404 或默认站











