Pyenv环境下bash终端、crontab重启及SSH执行时Python版本不一致问题

我在树莓派上使用pyenv 2.3.22，在~/.profile中配置了以下内容：

export PYENV_ROOT="$HOME/.pyenv"
command -v pyenv >/dev/null || export PATH="$PYENV_ROOT/bin:$PATH"
eval "$(pyenv init -)"

为实现系统启动时自动执行Python程序，我通过crontab -e添加了@reboot条目，但出现Python运行环境不一致的问题：

bash终端: Python 3.11.4
crontab启动: Python 3.9.2

版本差异导致程序无法正常运行。我将程序启动逻辑封装到bash脚本排查，发现除Python版本外，UserID、PATH等信息均正常。另一台树莓派情况更严重：

**bash终端:**
python  --version    -> 3.11.4
python3 --version    -> 3.11.4
**crontab启动:**
python  --version     -> 2.7.16
python3 --version     -> 3.7.3

我预期各启动方式的Python运行环境完全一致。<added 2023-10-07>通过远程主机SSH执行程序时，也出现与本地bash终端不同的运行环境。

1. 修复crontab的Python环境不一致问题 #

crontab默认以非登录shell执行，不会自动加载~/.profile里的pyenv配置，可通过两种方式解决：

• 直接修改crontab条目：
  编辑crontab：

  crontab -e
  

  将@reboot条目改为登录shell模式执行：

  @reboot bash -l -c "cd /你的项目路径 && python 你的脚本名.py"
  

  bash -l会触发登录shell，自动加载~/.profile完成pyenv初始化。

• 在启动脚本中手动加载pyenv：
  如果用bash脚本启动程序，在脚本开头添加：

  # 手动初始化pyenv
  export PYENV_ROOT="$HOME/.pyenv"
  export PATH="$PYENV_ROOT/bin:$PATH"
  eval "$(pyenv init -)"
  # 如果使用了pyenv virtualenv，追加以下内容
  # eval "$(pyenv virtualenv-init -)"
  

2. 修复SSH远程执行的环境不一致问题 #

远程SSH执行命令默认是非登录shell，不会加载~/.profile，可通过两种方式处理：

• 执行命令时指定登录shell：

  ssh 用户名@树莓派IP 'bash -l -c "python 你的脚本名.py"'
  

• 让非登录shell加载~/.profile：
  编辑~/.bashrc，在末尾添加：

  if [ -f ~/.profile ]; then
      . ~/.profile
  fi
  

  这样远程SSH执行命令时，非登录shell也会加载pyenv的配置。

3. 验证环境一致性 #

可以在启动脚本或crontab中添加日志输出，确认版本是否正确：

@reboot bash -l -c "python --version > /tmp/python_version.log 2>&1 && which python >> /tmp/python_version.log"

查看/tmp/python_version.log即可确认Python版本和路径是否符合预期。

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