Crontab重启自动执行脚本出现bundle command not found问题求助

我之前也碰到过一模一样的问题——手动跑脚本完全正常，放到crontab里就找不到bundle命令，核心原因其实很简单：crontab的执行环境和你登录shell后的环境差异很大，尤其是PATH环境变量的范围要小得多。

当你手动登录服务器时，你的shell会自动加载~/.bashrc、~/.profile这类配置文件，把Ruby版本管理器（比如rvm、rbenv）的路径、gem的bin路径都加到PATH里，所以能找到bundle命令。但crontab默认的PATH只有/bin:/usr/bin这种系统级的路径，根本找不到你安装的bundle。

下面是几个亲测有效的解决办法，按推荐程度排序：

1. 直接用bundle的绝对路径 #

这是最直接的方案，先手动执行which bundle找到bundle的绝对路径，比如输出可能是/home/deploy/.rvm/gems/ruby-2.7.0/bin/bundle或者/usr/local/bin/bundle。

然后把你脚本里的bundle install和bundle exec都替换成这个绝对路径：

# 替换成你实际查到的路径
/usr/local/bin/bundle install
/usr/local/bin/bundle exec cap staging deploy

2. 在脚本开头加载用户的shell环境 #

如果不想硬编码绝对路径，可以在脚本开头加载你登录时的环境配置，让crontab的执行环境和手动执行一致：

#!/bin/bash
# 加载bash的环境配置，确保PATH包含所有需要的路径
source ~/.bashrc
source ~/.profile

echo "Changing directory"
cd /home/deploy/source/myapp
# ... 后面的脚本内容不变

如果你用的是zsh，就把~/.bashrc换成~/.zshrc。

3. 针对Ruby版本管理器的特殊处理 #

如果你用了rvm或者rbenv来管理Ruby版本，还需要在脚本里初始化版本管理器的环境：

• 对于rvm：

  #!/bin/bash
  # 加载rvm的环境脚本
  source /usr/local/rvm/scripts/rvm
  # 指定要使用的Ruby版本（如果不是默认版本的话）
  rvm use ruby-2.7.0
  
  # ... 后面的脚本内容
  

• 对于rbenv：

  #!/bin/bash
  # 初始化rbenv环境
  eval "$(rbenv init -)"
  
  # ... 后面的脚本内容
  

额外的调试小技巧 #

• 不要等重启测试！可以临时加一个每分钟执行一次的crontab任务，快速验证修改是否有效：

  crontab -e
  # 添加这一行，1分钟后会执行脚本
  * * * * * /home/deploy/startup_script >> /home/deploy/startup_script.log 2>&1
  

• 在脚本开头加set -x，这样日志里会输出每一步执行的命令和变量值，方便排查哪里出问题：

  #!/bin/bash
  set -x
  # ... 后面的脚本内容
  

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