Yii2 SMTP DNS解析失败典型表现为Swift_TransportException，错误信息无“DNS”字样，常见Connection refused或超时；需捕获$e->getPrevious()->getMessage()、用gethostbyname()或nslookup验证解析结果。
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，两步缺一不可。
