Node.js 发起 HTTP 请求时 PHP 返回 500 或空响应的常见原因是旧版 PHP（≤7.2）未正确处理 application/json 请求体：$_POST 无法获取，php://input 可能为空；需在 php.ini 中设 always_populate_raw_post_data = -1 且 enable_post_data_reading = Off，重启服务后用 file_get_contents('php://input') 安全读取并 json_decode 解析，避免与 $_POST 混用；若不可改配置，Node.js 侧可降级为 application/x-www-form-urlencoded 格式发送。
Node.js 发起 HTTP 请求时 PHP 返回 500 或空响应
常见原因是旧版 PHP（如 5.6、7.0）默认关闭 always_populate_raw_post_data，且未正确处理 application/json 请求体。Node.js 的 axios 或 fetch 默认发送 JSON，但 PHP 无法通过 $_POST 获取——它压根没被解析，php://input 又可能为空。
- 确认 PHP 版本：
php -v；若 ≤ 7.2，需手动启用原始输入支持 - 检查请求头：
Content-Type: application/json是触发问题的关键条件 - 不要依赖
$_POST读取 JSON 数据，旧版 PHP 不自动解析
PHP 配置必须改的两项：always_populate_raw_post_data 和 enable_post_data_reading
PHP 5.6+ 已弃用 always_populate_raw_post_data，但某些旧环境仍需设为 -1 才允许读取 php://input；而 enable_post_data_reading = Off 可防止 PHP 提前消耗输入流，确保 Node.js 发来的 JSON 能被完整读取。
- 在
php.ini中设置：always_populate_raw_post_data = -1 enable_post_data_reading = Off
- 修改后必须重启 Web 服务（如
sudo service apache2 restart或sudo systemctl restart php-fpm） - 若用 CGI/FastCGI 模式，仅改
php.ini不生效，需在脚本开头加ini_set('enable_post_data_reading', '0');
PHP 端安全读取 Node.js JSON 请求的写法
不能直接 json_decode($_POST)，也不能无条件 file_get_contents('php://input')——后者在 enable_post_data_reading = On 时会返回空字符串。
- 统一用以下模式读取原始体：
$raw = file_get_contents('php://input'); $data = json_decode($raw, true); if (json_last_error() !== JSON_ERROR_NONE) { http_response_code(400); exit('Invalid JSON'); } - 避免混合使用
$_POST和php://input，二者在旧版 PHP 中互斥 - 若 Node.js 发送的是
application/x-www-form-urlencoded，则保持enable_post_data_reading = On，让$_POST正常工作
Node.js 请求端可做的兼容性降级
不是所有 PHP 环境都能改配置，这时可在 Node.js 侧主动适配：把 JSON body 改成表单格式，绕过解析缺陷。
立即学习“PHP免费学习笔记（深入）”；
- 用
URLSearchParams构造请求体：const data = new URLSearchParams({ name: 'alice', age: '30' }); await fetch('/api.php', { method: 'POST', headers: { 'Content-Type': 'application/x-www-form-urlencoded' }, body: data }); - 避免使用
JSON.stringify()+application/json组合直连老旧 PHP - 注意：PHP 接收后仍要检查
$_POST，而非php://input
真正麻烦的不是配置本身，而是旧版 PHP 对输入流的“一次性消费”机制——一旦某个扩展或框架提前调用了 $_POST 或 getallheaders()，php://input 就再也读不到东西了。调试时务必用 file_get_contents('php://input') 开头立刻读取，别拖到中间逻辑里。
