Node.js调用PHP卡住主因是环境变量未继承、DLL依赖缺失或安全软件拦截；应改用spawn、显式传env和timeout、检查PHP扩展依赖、绕过UAC限制并预检权限。
Node.js 调用 PHP 可执行文件在 Windows 上卡住，90% 是因为环境变量没生效或权限被拦截，不是代码写错了。
PHP 命令在 cmd 能跑，但 child_process.exec 却卡死
这是最典型的“看似能用、实则失效”现象。Node.js 启动的子进程默认不继承用户登录会话的完整环境变量（尤其是 PATH），即使你在系统变量里加了 php.exe 路径，exec 仍可能找不到它或启动后无响应。
- 先用
child_process.spawn替代exec，它更底层、错误更透明； - 显式传入
env：把当前终端的 PATH 复制过去，比如{ env: { ...process.env, PATH: process.env.PATH } }； - 务必加
timeout选项（如{ timeout: 5000 }），否则卡住不会自动报错； - PHP 脚本开头加
ini_set('display_errors', '1'); error_reporting(E_ALL);，避免静默失败。
PHP 报错 Unable to load dynamic library 或直接退出无声
这说明 PHP 加载扩展时缺 DLL 依赖，常见于 php_curl.dll、php_openssl.dll 等。Windows 下这些 DLL 往往依赖 libssh2.dll、ssleay32.dll 等运行时库，而它们不在系统 PATH 里，或版本不匹配。
- 用
depends.exe（老但有效）打开对应 DLL，看红色标记的缺失模块； - 把 PHP 安装目录下的
ext和libssh2.dll所在目录（常是php\根目录）都加进env.PATH； - 不要混用不同 PHP 版本的 DLL（比如用 PHP 8.2 的
php_curl.dll配 PHP 8.1 的php.exe）； - 若用 XAMPP/WAMP，优先用其自带的
php.exe，别单独下载 ZIP 包——后者常缺配套 DLL。
Node.js 进程被 Windows SmartScreen 或杀毒软件拦截
尤其在调用 php.exe 执行网络请求类脚本（如 file_get_contents("https://...")）时，部分安全软件会临时挂起子进程，表现为 Node.js 一直等待、无输出、无超时、任务管理器里 php.exe 显示“挂起”状态。
立即学习“PHP免费学习笔记（深入）”；
- 临时关闭 SmartScreen（设置 → 更新与安全 → Windows 安全中心 → 应用与浏览器控制 → 基于声誉的保护）；
- 把你的项目目录加进杀毒软件白名单（特别是 Windows Defender 的“受控文件夹访问”）；
- 用
spawn启动时加上stdio: 'inherit'，这样能看到 PHP 是否弹出 UAC 提示或被拦截日志； - 如果只是本地开发，可改用
php -S启一个内置服务器，让 Node.js 改为 HTTP 调用，绕过本地执行限制。
权限不足导致 PHP 写文件/读配置失败
Node.js 以当前用户身份运行，但若你用管理员启动 CMD 再运行 node app.js，PHP 子进程可能继承到更高完整性级别（Medium vs High），反而无法访问用户目录下的文件（UAC 虚拟化或路径重定向）。
- 统一用普通权限运行 Node.js（不要右键“以管理员身份运行”）；
- 检查 PHP 脚本中所有
fopen、file_put_contents的路径是否为绝对路径，相对路径易因工作目录不一致而写错位置； - 用
process.cwd()打印 Node.js 当前工作目录，再在 PHP 中用getcwd()对比，确认是否一致； - 涉及写入
C:\Windows\Temp或用户AppData时，显式用fs.accessSync(path, fs.constants.W_OK)在 Node.js 侧预检权限。
真正卡住的时候，往往不是 PHP 或 Node.js 单独的问题，而是两层环境叠加后暴露的 Windows 权限模型和 DLL 加载机制细节。多打一行 console.log 查 PID，用 Process Explorer 看子进程加载了哪些模块，比反复改代码更快定位。
