Node.js调用PHP接口失败主因是协议或端口不匹配，需先用curl验证PHP服务是否运行并可访问，再检查host解析、Docker端口映射、协议端口硬编码、Basic Auth头及区分CORS适用场景。
Node.js 调用 PHP 接口失败，大概率不是代码逻辑问题，而是协议或端口没对上——尤其当 PHP 接口跑在本地开发环境（如 XAMPP、phpstudy、Docker）时。
确认 PHP 接口是否真在运行且可被 Node.js 访问
很多失败源于“以为接口开着，其实根本没启动”或“只在浏览器能打开，Node.js 请求被拒绝”。
- 在终端执行
curl -v http://localhost:8080/api.php（把地址换成你的实际地址），看是否返回 HTTP 200 和预期数据；如果连curl都超时或报Connection refused，说明 PHP 服务根本没监听该地址+端口 - 检查 PHP 服务绑定的 host：比如
127.0.0.1:8080和localhost:8080在某些系统（尤其是 macOS 或 Docker）下 DNS 解析行为不同；Node.js 默认走 IPv6 时可能卡在localhost解析，建议统一用127.0.0.1 - 若 PHP 在 Docker 容器里，确保端口已正确映射（如
-p 8080:80），且 Node.js 请求的是宿主机 IP（http://localhost:8080），不是容器内网 IP（如http://172.17.0.2:80）
检查 Node.js 发起请求时的协议与端口硬编码
常见错误是复制了浏览器地址栏里的 URL，但没注意它其实是 HTTPS，而 PHP 接口实际只支持 HTTP；或者端口写错（比如把 8080 写成 80，或漏掉端口导致默认走 80/443）。
- 浏览器地址栏显示
https://api.example.com/v1/data→ Node.js 不能直接照搬，要确认后端 PHP 是否真有 TLS 配置；否则改用http://api.example.com:8080/v1/data - 使用
axios或node-fetch时，URL 必须显式带协议和端口：http://127.0.0.1:8080/api.php，不能只写/api.php（那是相对路径，Node.js 不懂） - 如果 PHP 接口启用了基础认证（Basic Auth），Node.js 请求头必须带上
Authorization字段，否则会返回 401；漏掉这个常被误判为“连接失败”
跨域（CORS）不是 Node.js 的问题，但容易误导排查方向
Node.js 服务端调用 PHP 接口，不经过浏览器，所以 Access-Control-Allow-Origin 头完全无关。如果你看到控制台报 CORS 错误，那说明你实际是在前端浏览器里用 JavaScript（如 fetch）发起的请求，不是 Node.js 后端调用。
立即学习“PHP免费学习笔记（深入）”；
- 区分清楚调用主体：是 Node.js 的
axios.get()？还是浏览器里运行的 React/Vue 组件里的fetch()？两者网络链路完全不同 - 如果是后者，PHP 接口需设置响应头：
header('Access-Control-Allow-Origin: *');（仅开发环境），但这是 PHP 侧的事，和 Node.js 代码无关 - Node.js 作为客户端，唯一要关心的是目标地址能否 TCP 连通、HTTP 状态码是否正常（如 200、400、500），而不是 CORS
真正卡住的地方，往往在最开始——比如 PHP 服务监听的是 127.0.0.1:8080，而 Node.js 请求的是 http://localhost:8080，在某些系统下解析到 ::1（IPv6），结果连不上；又或者防火墙/杀毒软件拦截了本地端口通信。先用 curl 验证通路，再动代码，省下大半调试时间。
