PHP调用shell_exec执行后台脚本时始终阻塞等待执行完成如何解决

核心问题原因 #

你遇到的阻塞问题本质是PHP运行时默认会等待所有派生的子进程关闭全部I/O管道、脱离当前会话后才会结束请求返回响应，你本地控制台运行shell脚本时是交互式会话，会自动处理后台进程的脱离，而PHP调用时没有自动处理这个逻辑，所以会等待子进程执行完成。

可落地的解决方案 #

方案1：修正命令调用写法，强制进程完全脱离会话 #

调整你调用shell脚本的PHP代码，显式让进程脱离当前会话、丢弃所有输入输出，避免PHP等待：

// 写法1：加nohup，修正重定向顺序后后台运行
$your_command = 'nohup /path/to/test.sh > /dev/null 2>&1 &';
shell_exec($your_command);

// 写法2：如果写法1无效，额外加setsid彻底脱离会话组
$your_command = 'setsid /path/to/test.sh > /dev/null 2>&1 &';
shell_exec($your_command);

方案2：提前结束请求输出（PHP-FPM环境优先用） #

如果你的服务用PHP-FPM运行，可以直接主动提前结束HTTP连接，后续逻辑不管执行多久都不会让前端用户等待：

// 先输出所有需要返回给前端的内容
echo "任务已提交成功";
// 主动发送响应给用户，关闭HTTP连接
fastcgi_finish_request();
// 之后的逻辑不会阻塞用户
$your_command = '/path/to/test.sh';
shell_exec($your_command);

这个方案兼容性最高，不需要调整shell脚本逻辑，也不用纠结进程脱离的规则。

方案3：修改shell脚本逻辑 #

如果不想改PHP调用代码，可以直接调整shell脚本，让curl调用完全脱离后主动退出shell进程：

#!/bin/bash
nohup curl -X POST -F 'name=linuxize' -F 'email=linuxize@example.com' https://mySite/test.php > /dev/null 2>&1 &
# 主动退出当前shell，避免PHP等待shell进程结束
exit 0

补充排查点 #

• 确认web运行用户（如www-data、apache）有对应shell脚本的执行权限，以及curl目标地址的访问权限
• 如果代码中开启了session，调用shell脚本前先执行session_write_close()关闭session锁，避免后续同用户的请求被阻塞
• 不要用exec()、system()这类会捕获进程返回值的函数替代shell_exec()，前两者更容易出现等待子进程的问题

内容的提问来源于stack exchange，提问作者user10663015