使用Boto3 UserData在EC2安装Miniconda时$HOME变量异常问题

问题根源 #

通过su - ec2-user在UserData脚本中切换用户时，默认是以非交互式非登录shell执行命令，不会加载ec2-user的登录环境配置（比如.bash_profile），导致HOME变量未被正确初始化。而手动执行时是交互式登录shell，环境变量自动加载，所以不会出错。如果Miniconda安装脚本开启了set -u（未绑定变量即报错）的严格模式，就会触发HOME: unbound variable错误。

解决方案 #

1. 使用sudo -u ec2-user -i替代su - ec2-user #

-i参数会模拟ec2-user的登录shell，自动加载其环境变量（包括HOME），是最可靠的方式。修改UserData中的执行命令：

sudo -u ec2-user -i bash -c "
wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh -O /tmp/miniconda3.sh
bash /tmp/miniconda3.sh -b
"

2. 强制su加载登录环境 #

如果坚持使用su，添加-l（或--login）参数强制加载登录环境，确保HOME变量被正确设置：

su - ec2-user -l -c 'bash -c "
wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh -O /tmp/miniconda3.sh
bash /tmp/miniconda3.sh -b
"'

3. 手动指定HOME变量（应急方案） #

如果前两种方式仍有问题，可在执行安装脚本前手动指定HOME：

su - ec2-user -c 'HOME=/home/ec2-user bash -c "
wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh -O /tmp/miniconda3.sh
bash /tmp/miniconda3.sh -b
"'

额外注意事项 #

• 确保/tmp/miniconda3.sh文件有可执行权限，可在下载后添加chmod +x /tmp/miniconda3.sh
• Miniconda的-b参数是静默安装，会默认安装到$HOME/miniconda3，环境变量加载需要后续配置（比如在ec2-user的.bashrc中添加source $HOME/miniconda3/bin/activate）

内容的提问来源于stack exchange，提问作者Alfie González