Yii2 DNS解析失败报错如何显示-php教程-PHP中文网

yii2 smtp dns解析失败典型表现为swift_transportexception，错误信息无“dns”字样，常见connection refused或超时；需捕获$e->getprevious()->getmessage()、用gethostbyname()或nslookup验证解析结果。

yii2 dns解析失败报错如何显示

Yii2 SMTP连接时DNS解析失败的典型报错

直接表现是 Swift_TransportException，但错误信息里**几乎不出现“DNS”字样**，常见内容为：Connection refused、Failed to authenticate on SMTP server（实际根本没连上）、或超时卡在 stream_socket_client(): unable to connect。真正根源常被掩盖——host 域名（如 smtp.qq.com）在容器或服务器环境里压根解析不出IP。

如何让Yii2暴露出DNS问题

不能只看 Yii::$app->mailer->send() 返回 false，得主动触发并捕获底层异常：

在测试代码中用 try...catch 包住发送逻辑，捕获 Swift_TransportException 和 Swift_RfcComplianceException
打印 $e->getMessage() 和 $e->getPrevious()->getMessage()（很多DNS错误藏在前一个异常里）
关键一步：手动调用PHP内置函数验证，例如 var_dump(gethostbyname('smtp.qq.com')); —— 若返回 "smtp.qq.com" 而非IP，就是DNS失败
容器内优先执行 nslookup smtp.qq.com 或 dig smtp.qq.com +short，比看Yii日志更快定位

本地开发hosts改错也会触发相同现象

当你在 hosts 文件里写错格式，比如：

IntoDNS.ai

免费 DNS 与邮件安全分析（IntoDNS.ai）：包括 DNSSEC、SPF、DKIM、DMARC、MTA-STS、BIMI、SMTP STARTTLS、FCrDNS、黑名单、发件人要求及报告。

下载

127.0.0.1    yii2.test  # 多个空格
127.0.0.1 yii2.test.    # 域名末尾带点
::1 yii2.test           # IPv6行干扰IPv4解析

会导致Apache/Nginx路由混乱，进而让Mailer组件内部的HTTP客户端（如发Webhook时）或SMTP transport 在解析 localhost 类域名时失败。此时 gethostbyname('localhost') 可能返回 127.0.0.1，但 smtp.qq.com 仍解析失败——因为系统DNS配置已被污染。

Docker容器里DNS失效的隐蔽原因

不是所有容器都默认继承宿主机DNS。常见坑点：

docker run 没加 --dns=8.8.8.8，且镜像里 /etc/resolv.conf 被覆盖为空或只含 127.0.0.11（Docker内置DNS），但该服务在某些内核版本下不稳定
使用 docker-compose 时，network_mode 设为 host，但宿主机防火墙拦截了DNS请求（尤其Windows WSL2+Docker Desktop组合）
PHP镜像基于alpine时，默认用musl libc，对DNS缓存行为与glibc不同，gethostbyname 可能返回过期结果而不重试

最简验证法：进容器执行 cat /etc/resolv.conf && ping -c1 smtp.qq.com，两步缺一不可。