Laravel控制器执行Bash脚本时git pull等命令失效问题排查

常见原因及对应解决方案 #

1. 环境变量路径缺失 #

Web服务器运行用户（如www-data、apache）的PATH变量未包含git、composer的可执行路径，而手动运行脚本时用的是当前登录用户的完整PATH，因此能正常找到命令。

解决方式：

• 直接在脚本中使用命令绝对路径：先通过which git和which composer获取绝对路径，将脚本中的git pull --progress替换为/usr/bin/git pull --progress，composer install替换为/usr/local/bin/composer install（路径以实际查询结果为准）。
• 在脚本开头手动追加环境变量：

  export PATH=$PATH:/usr/bin:/usr/local/bin
  

2. 用户权限不足 #

Web服务器用户没有git仓库的访问权限（如SSH密钥未配置、仓库读写权限缺失），或没有composer缓存目录的读写权限。

解决方式：

• 为web用户配置git SSH密钥：切换到web用户（如su -s /bin/bash www-data，针对nologin用户），生成SSH密钥并添加到git仓库的权限设置中。
• 确保web用户对项目目录及composer缓存目录（通常为~/.composer）拥有读写权限，或执行composer时添加--no-cache参数临时跳过缓存。

3. Symfony Process组件配置问题 #

默认情况下Process组件可能未继承完整环境变量，或未设置正确的工作目录。

解决方式：

• 在Laravel控制器中执行Process时指定项目根目录为工作目录：

  use Symfony\Component\Process\Process;
  
  $process = new Process(['bash', '/path/to/deploy.sh']);
  $process->setWorkingDirectory(base_path()); // 绑定Laravel项目根目录
  $process->run();
  
  // 打印错误输出用于排查
  echo $process->getErrorOutput();
  

• 手动继承并补全环境变量：

  $process->setEnv(array_merge($_ENV, ['PATH' => getenv('PATH') . ':/usr/bin:/usr/local/bin']));
  

4. Git交互模式阻塞 #

若git仓库为HTTP协议，执行pull时需要输入用户名密码，Process在非交互模式下会卡住无输出。

解决方式：

• 改用SSH协议的git仓库，避免交互式密码输入。
• 在web用户下配置git凭据助手，自动保存凭据：

  git config --global credential.helper store
  

5. 强制输出错误信息排查 #

无输出往往是命令执行出错但未捕获错误，在控制器中主动获取错误输出：

$process->run();
if (!$process->isSuccessful()) {
    dd($process->getErrorOutput());
}

通过错误信息可快速定位具体问题，如权限不足、命令不存在等。

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