PHPEnv站点访问失败？DNS与Hosts排查指南

phpEnv站点无法访问往往并非PHP或Nginx故障，而是本地域名解析环节“静默失效”——当ping yoursite.test返回Unknown host时，问题几乎必然出在DNS与Hosts协同机制上：要么hosts文件格式错误（如中文标点、多余空格、重复条目）、未刷新系统DNS缓存，要么nsswitch.conf中缺失files导致hosts被跳过，又或是HTTP_PROXY环境变量偷偷劫持了本该直连127.0.0.1的请求；本文直击这四大隐形元凶，提供从诊断命令到修复操作的一站式排查路径，帮你3分钟定位、5分钟解决那个“明明服务跑着却打不开”的诡异问题。

phpEnv站点打不开，先确认是DNS还是Hosts问题

“站点无法访问”在 phpEnv 中大概率不是 PHP 或 Nginx 坏了，而是域名根本没解析成功——ping yoursite.test 返回 Unknown host 就能直接锁定。phpEnv 本身不接管 DNS，它依赖系统级解析流程：先查 /etc/hosts（Windows 是 C:\Windows\System32\drivers\etc\hosts），再走 /etc/resolv.conf 配置的 DNS 服务器。所以排查必须按这个顺序来。

• 打开终端，运行 ping yoursite.test；如果失败，立刻执行 nslookup yoursite.test 1.1.1.1（绕过本地 DNS）
• 若 nslookup 成功返回 IP，说明本地 DNS 服务异常，问题出在 resolv.conf 或路由器 DNS 设置
• 若 nslookup 也失败，但 ping 8.8.8.8 能通，说明网络连通性正常，问题只剩两个：hosts 文件没配对，或域名压根没加进 hosts
• 检查 phpEnv 的站点配置里写的域名（如 yoursite.test）是否和 hosts 里完全一致——大小写、末尾点号（.test）、空格都不能错

hosts 文件配错是 phpEnv 最常见的“假故障”

phpEnv 站点通常用 .test、.local 这类本地域名，必须靠 hosts 手动绑定。配错一行，整个站点就 404 或连接被拒绝。

• Windows 用户用记事本（**右键 → 以管理员身份运行**）打开 C:\Windows\System32\drivers\etc\hosts；macOS/Linux 用 sudo nano /etc/hosts
• 确认格式严格为：127.0.0.1 yoursite.test —— IP 和域名之间只能是空格或 Tab，不能是中文标点、逗号、等号
• 删掉所有重复行、带 # 却没注释完的残缺行、以及指向旧 IP 的废弃条目（比如之前配过 192.168.10.10 现在已不用）
• 保存后必须刷新系统 DNS 缓存：ipconfig /flushdns（Win）、sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder（macOS）、sudo systemd-resolve --flush-caches（Linux systemd）
• 某些安全软件（如火绒、360）会锁住 hosts 文件，保存失败时看文件属性是否只读，或临时退出防护软件再试

phpEnv 启动后仍无法解析，检查 nsswitch.conf 是否跳过 files

Linux/macOS 下，系统决定“先查 hosts 还是先查 DNS”的逻辑由 /etc/nsswitch.conf 控制。如果这行被改成了 hosts: dns（删掉了 files），那 hosts 文件再怎么配都无效——系统直接跳过去查 DNS，而你本地域名在公网 DNS 根本不存在。

• 运行 grep "^hosts:" /etc/nsswitch.conf，正确输出应为：hosts: files dns（顺序不重要，但 files 必须存在）
• 如果只有 dns，编辑该文件，把 files 加回去，例如改成 hosts: files dns myhostname
• 改完无需重启，立即生效；之后再 ping yoursite.test 就能验证是否走到了 hosts
• macOS 默认用 myhostname 替代 files，但仅限 .local 域名；.test 类必须靠 files，所以 macOS 用户也得确保这一项在

别让 HTTP_PROXY 搞乱 phpEnv 的本地请求

phpEnv 本身不走代理，但如果你在终端里设过 HTTP_PROXY 环境变量（比如公司网络、IDE 内置终端、Docker Desktop 自动注入），curl、wget 甚至部分 PHP 扩展（如 Guzzle）会偷偷转发请求到代理地址——而代理服务器显然不认识 yoursite.test。

• 运行 env | grep -i proxy，看是否输出 HTTP_PROXY、HTTPS_PROXY 或 NO_PROXY
• 如果存在，临时清掉：unset HTTP_PROXY HTTPS_PROXY（Linux/macOS）或 set HTTP_PROXY=（Win CMD）
• 重点检查 NO_PROXY 是否漏了 .test，应设为类似 localhost,127.0.0.1,.test,.local（注意开头的点号）
• phpEnv 的 Nginx 日志（logs/error.log）里若出现 connection refused by 127.0.0.1:8888 这类错误，基本就是代理把请求转去错端口了

到这里，我们也就讲完了《PHPEnv站点访问失败？DNS与Hosts排查指南》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于phpenv的知识点！