CI/CD通过SSH执行composer install提示命令未找到如何解决？

问题根因 #

报错的核心原因是非交互式SSH会话默认不会加载用户目录下的.bashrc配置：你手动SSH登录服务器属于交互式shell会话，会正常读取.bashrc里的别名、PATH变量配置，所以可以正常调用composer；但CI/CD中调用SSH执行远程命令属于非交互式会话，不会加载.bashrc，所以你此前添加的composer别名完全不生效，才会返回command not found报错。

修复方案（按推荐优先级排序） #

方案1：使用composer绝对路径调用（最稳妥，无需改配置） #

1. 先手动登录服务器，执行命令 which composer 获取composer的实际绝对路径，示例返回值类似：/home/youruser/.config/composer/vendor/bin/composer
2. 将CI配置里的composer install替换为拿到的绝对路径即可，修改后配置示例：

deploy:
  stage: deploy
  script:
    - ssh -tt user@domain.com
      "cd /path/to/public_html/ &&
      git checkout master &&
      git pull &&
      /home/youruser/.config/composer/vendor/bin/composer install &&
      exit"

该方案不受shell会话类型限制，适配jailshell受限环境，稳定性最高。

方案2：强制SSH会话加载用户配置 #

在SSH执行的命令开头主动加载.bashrc配置即可，修改后配置示例：

deploy:
  stage: deploy
  script:
    - ssh -tt user@domain.com
      "source ~/.bashrc &&
      cd /path/to/public_html/ &&
      git checkout master &&
      git pull &&
      composer install &&
      exit"

如果执行后仍不生效，可以尝试将~/.bashrc替换为~/.bash_profile，部分系统的非交互式会话会优先读取该配置文件。

方案3：将composer添加到全局PATH（需服务器管理员权限） #

如果有服务器root权限，可以直接将composer二进制文件移动到系统全局PATH包含的目录下，示例操作：

# 先拿到composer路径
composer_path=$(which composer)
# 移动到全局目录
mv $composer_path /usr/local/bin/composer
# 给执行权限
chmod +x /usr/local/bin/composer

操作完成后所有类型的shell会话都可以直接调用composer命令。

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