GitLab CI/CD通过SSH登录服务器时未完全加载~/.bash_profile

核心原因：Bash 启动脚本的加载逻辑差异 #

本地 SSH 登录属于交互式登录 Shell，Bash 会依次加载 /etc/profile、~/.bash_profile、~/.bash_login、~/.profile（找到第一个存在的就停止）；而 GitLab CI/CD 流水线发起的 SSH 会话通常是非交互式非登录 Shell，此时 Bash 默认只会加载 ~/.bashrc，不会触发 ~/.bash_profile 的加载——这就是你的 nvm 等配置失效的根本原因，哪怕当前 Shell 是 /bin/bash 也没用。

解决方案 #

方案1：让 ~/.bashrc 自动加载 ~/.bash_profile #

在服务器的 ~/.bashrc 文件末尾添加以下代码，确保所有 Shell 会话（不管交互式还是非交互式）都能加载到 ~/.bash_profile 的配置：

if [ -f ~/.bash_profile ]; then
    source ~/.bash_profile
fi

方案2：在 CI 命令中强制以登录 Shell 模式启动 Bash #

在 GitLab CI 的 job 脚本里，执行 SSH 命令时加上 -l 参数让 Bash 以登录 Shell 模式运行，强制加载 ~/.bash_profile：

ssh your-user@your-server bash -l -c '你的执行命令'

如果需要执行多个命令，也可以用这种方式：

ssh your-user@your-server << EOF
bash -l
# 这里写你要执行的命令，比如 nvm use 18 && npm install
EOF

额外检查点 #

• 检查 ~/.bash_profile 里的 nvm 初始化代码是否包含交互式判断（比如 [[ $- == *i* ]] 或者 if [ -n "$PS1" ]; then），非交互式 Shell 会跳过这类条件包裹的代码，需要把 nvm 初始化逻辑移到条件外。
• 确认服务器上的 ~/.bash_profile 权限正确（至少 644），避免 CI 会话无权限读取。

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