localhost解析为::1导致Nginx拒绝连接，因其默认仅监听127.0.0.1:80；解决方法包括注释hosts中::1 localhost、修改nginx.conf为listen 80; listen [::]:80 ipv6only=off;并重启服务。
localhost 解析到 ::1 导致 nginx 拒绝连接
Windows 上 localhost 默认同时解析为 127.0.0.1（IPv4）和 ::1（IPv6），而 phpEnv 中的 nginx 默认只监听 127.0.0.1:80，不监听 ::1:80。浏览器访问 http://localhost 时，若 DNS 解析优先返回 ::1，连接就会失败——现象就是“已拒绝连接”，但 127.0.0.1 正常。
验证方法：ping localhost，如果回复来自 ::1，就确认是 IPv6 优先问题。
- 临时解决：在
C:\Windows\System32\drivers\etc\hosts中注释掉::1 localhost这一行（前面加#），只保留127.0.0.1 localhost - 更稳妥做法：修改 nginx 配置，让其同时监听 IPv4 和 IPv6。打开
D:\Download\phpEnv\server\nginx\conf\nginx.conf，找到server块中的listen行，改为：listen 80; listen [::]:80;
- 改完后必须重启 nginx：
nginx -s reload或通过 phpEnv 界面点击“重启”
Edge/Chrome 缓存导致 localhost 重定向或连接失败
浏览器（尤其是 Edge 和 Chrome）会缓存 localhost 的 HTTPS 重定向、证书错误、甚至 DNS 解析结果。你遇到的 https://localhost:1234 拒绝连接，但 http://127.0.0.1:1234 正常，很可能是因为浏览器强制跳转 HTTPS 后又因无有效证书失败，且缓存了该行为。
- 直接访问
http://localhost:80（显式带http://），避免浏览器自动补https://） - 清除 Edge 浏览器的全部缓存：访问
edge://settings/privacy?search=清除浏览数据→ 勾选“Cookie 及其他网站数据”“缓存的图像和文件”→ 时间范围选“所有时间”→ 清除 - 测试前关闭所有 Edge 标签页，再新开一个无痕窗口访问，排除扩展干扰
phpEnv 的 nginx 实际监听地址未覆盖 0.0.0.0
即使 hosts 和浏览器都正常，localhost 仍连不上，说明 nginx 没有真正接受来自本机的连接请求。常见原因是配置中 listen 写死了 127.0.0.1:80，而非更通用的 0.0.0.0:80 或未启用 ipv6only=off。
立即学习“PHP免费学习笔记（深入）”；
- 检查
nginx.conf中的listen指令是否含127.0.0.1:80；若有，建议替换为：listen 80; listen [::]:80 ipv6only=off;
-
ipv6only=off是关键：它允许一个 socket 同时处理 IPv4 映射的 IPv6 连接（即::ffff:127.0.0.1），兼容性更好 - 若使用自定义端口（如 1234），确保
listen 1234和listen [::]:1234 ipv6only=off都存在 - 改完务必验证语法：
nginx -t，再 reload
Xdebug 连接失败不只是 localhost 解析问题
xdebug.client_host=localhost 在 php.ini 中看似合理，但 VS Code 的 Xdebug 扩展实际发起连接时，可能受宿主机网络栈影响。当系统 IPv6 优先且 xdebug 未监听 ::1，就会超时断开。
- 将 php.ini 中的
xdebug.client_host改为127.0.0.1（不要用localhost） - 确认
xdebug.client_port=9003与 VS Code 的launch.json中port一致 - 检查 Windows 防火墙是否放行
9003端口入站（即使本地连接，部分防火墙策略仍生效） - 启动调试前，在终端运行
netstat -ano | findstr :9003，确认 php-cgi 或 php.exe 确实在监听该端口
最易被忽略的是：改完 php.ini 后没重启 phpEnv 的 PHP 服务，导致配置未加载。phpEnv 界面里“PHP”服务旁的“重启”按钮必须点一次，不能只 reload nginx。
