PHP跨平台调用失败主因是网络可达性、地址语义误解和通信路径未打通；需按WSL、Docker、跨域等场景分别排查绑定地址、防火墙、容器网络、CORS配置及TCP连通性。
一、WSL中PHP调Windows上Python服务连不上
典型表现：PHP用file_get_contents('http://127.0.0.1:8000')返回false或超时。
根本原因：WSL2的127.0.0.1指向WSL自己，不是Windows主机；且Windows防火墙默认拦截WSL入站连接。
- 把Python服务启动时绑定到
0.0.0.0:8000（例如flask run --host=0.0.0.0 --port=8000），不能只绑127.0.0.1 - 在Windows上放行对应端口：
New-NetFirewallRule -DisplayName "Allow WSL Python Port 8000" -Direction Inbound -Protocol TCP -LocalPort 8000 -Action Allow - PHP中改用Windows主机的真实IP：执行
cat /etc/resolv.conf | grep nameserver | awk '{print $2}'获取IP（如172.28.16.1），再拼URL："http://{$win_ip}:8000/api" - 先在WSL终端运行
curl -v http://172.28.16.1:8000验证通路，成功后再查PHP逻辑
二、Docker里PHP容器调Python容器失败
典型表现：cURL报Connection refused，或域名python-app解析失败。
根本原因：两容器不在同一自定义网络，或Python服务没监听0.0.0.0，或PHP写的是localhost而非容器名。
立即学习“PHP免费学习笔记（深入）”；
- 确认使用自定义Docker网络（非默认
bridge）：docker network create myapp-network，启动时都加--network myapp-network - 检查Python容器是否监听全地址：
docker exec python-app netstat -tuln | grep :8000，输出中必须含0.0.0.0:8000或:::8000 - PHP代码中URL必须用容器名：
http://python-app:8000/data，不能写http://localhost:8000或http://127.0.0.1:8000 - 调试时进PHP容器手动测试：
docker exec -it php-app curl -v http://python-app:8000/health
三、PHP跨域头已设但前端仍报错
常见于Nginx/Apache部署后，响应头被覆盖或OPTIONS请求根本没进PHP。
- 检查PHP脚本顶部是否有BOM、空格、
echo等提前输出——header()会因此失效 - Nginx需显式处理OPTIONS预检：
if ($request_method = 'OPTIONS') { add_header ...; return 204; }，否则405直接拦在Web服务器层 - 确认Web服务器没用
fastcgi_hide_header或缓存插件把Access-Control-Allow-Origin头给删了 - 浏览器开发者工具→Network→点击请求→看Response Headers里是否真有CORS头，而不是只看PHP代码写了没
四、统一建议：先通路，再逻辑
跨平台调用失败，80%是网络层没通，不是代码写错了。别急着改PHP业务逻辑。
- 用
curl或telnet在调用方环境直连目标地址和端口，确认能建立TCP连接 - 确认目标服务确实在监听，且绑定的是
0.0.0.0而非127.0.0.1 - 禁用所有中间件（如防火墙、代理、CDN），最小化复现问题
- 日志要查两边：PHP进程日志 + Python服务日志，看请求到底有没有抵达
