根本原因是WSL2网络隔离导致localhost语义混淆：WSL2中127.0.0.1指向自身而非Windows主机，且Windows防火墙默认拦截WSL入站连接；需绑定0.0.0.0、放行端口、用nameserver IP替代localhost。
WSL里PHP调用exec('python script.py')失败，提示连接超时或ConnectionRefusedError
根本原因不是PHP或Python本身的问题，而是WSL2默认使用虚拟网卡（vEthernet），和Windows主机不在同一物理网络段，且Windows防火墙默认拦截来自WSL的入站连接。PHP子进程调用Python脚本若涉及启动本地HTTP服务（比如flask run --host=0.0.0.0）、请求http://localhost:5000、或调用requests.get('http://127.0.0.1:8000')，大概率失败。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 确认Python服务是否真在监听外部接口：运行
python -m http.server 8000 --bind 0.0.0.0:8000后，在WSL里curl http://0.0.0.0:8000能通，但Windows里curl http://localhost:8000不通 → 说明服务没暴露给Windows - 把Python服务绑定到
0.0.0.0（而非127.0.0.1），并明确指定端口 - 在Windows上手动放行该端口：以管理员身份运行PowerShell，执行
New-NetFirewallRule -DisplayName "Allow WSL Python Port 8000" -Direction Inbound -Protocol TCP -LocalPort 8000 -Action Allow - 避免依赖
localhost：WSL2中localhost指向WSL自身，Windows中localhost指向Windows自身；跨系统通信请统一用host.docker.internal（仅限Docker Desktop启用时）或查WSL IP：cat /etc/resolv.conf | grep nameserver | awk '{print $2}'，然后在PHP里请求该IP（如http://172.28.16.1:8000/api）
PHP用file_get_contents('http://127.0.0.1:8000')在WSL里始终返回false
这是最典型的“localhost语义混淆”问题。WSL2中127.0.0.1是WSL自己的回环地址，不是Windows主机。即使Python服务跑在Windows上，PHP子进程也连不到它。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 不要硬写
127.0.0.1或localhost，改用WSL可路由到Windows的特殊地址：host.docker.internal（需Docker Desktop开启）或更通用的$(cat /etc/resolv.conf | grep nameserver | awk '{print $2}')返回的IP（通常是172.x.x.1） - 在PHP中动态获取该地址：
$win_ip = trim(shell_exec("cat /etc/resolv.conf | grep nameserver | awk '{print \$2}'"));，再拼URL："http://{$win_ip}:8000/data" - 验证连通性优先于调试PHP逻辑：在WSL终端直接
curl -v http://172.28.16.1:8000，看到HTTP响应头才算基础通路成立 - 注意Windows服务是否监听所有接口：比如Flask默认只监听
127.0.0.1，必须显式加--host=0.0.0.0
WSL1 vs WSL2网络行为差异导致PHP-Python协作表现不一致
WSL1共享Windows网络栈，localhost和127.0.0.1在WSL1里确实指向Windows主机；而WSL2是轻量级VM，有独立内核和网络命名空间，localhost不再等价。升级到WSL2后原有PHP调用突然失效，基本就是这个原因。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 临时降级验证：运行
wsl --set-version MyUbuntu 1切回WSL1，如果PHP调用立刻恢复，就坐实是网络模型变更所致 - 长期方案别切回WSL1（缺systemd、容器兼容差），应适配WSL2网络模型：所有跨系统HTTP调用都显式使用Windows主机IP，而非
localhost - 避免在代码里写死
localhost：提取为配置项或环境变量，例如PHP_PYTHON_API_HOST=${WSL_WIN_HOST:-'172.28.16.1'} - 注意WSL2的IP每次重启可能变化（尤其宿主机WiFi切换时），所以不要写死IP，要用
/etc/resolv.conf里的nameserver动态读取
PHP子进程执行Python脚本后，Python报urllib.error.URLError:
这说明Python脚本自己又去反向请求了某个地址（比如调用第三方API、或访问另一个本地服务），而那个目标地址在WSL网络环境下不可达。常见于Python脚本里写了requests.get('http://localhost:3000')，但3000服务实际跑在Windows上——此时Python在WSL里，localhost还是指WSL自己。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 在Python脚本内部也做同样处理：用
os.popen("cat /etc/resolv.conf | grep nameserver | awk '{print $2}'").read().strip()获取Windows IP，再构造请求URL - 或者统一由PHP传入主机IP作为参数：
exec("python script.py --api-host {$win_ip}")，Python用argparse接收 - 检查Python脚本是否用了代理（如
HTTP_PROXY环境变量），WSL里设的代理可能把请求导向错误路径 - 用
strace -f -e trace=connect python script.py 2>&1 | grep -i 'connect.*127'抓底层连接目标，快速定位是哪一行代码在连错地址
localhost含义都不同。最容易被忽略的是：Python脚本自己发起的出站请求，往往没人检查它的网络上下文。 
