MacBook更新AWS CLI后AWS_PROFILE环境变量失效求助

我之前更新AWS CLI后也碰到过一模一样的问题，每次都要加--profile确实挺折腾的，给你整理几个大概率能解决的排查方向和原因：

1. 先确认AWS CLI版本（v1 vs v2） #

AWS CLI v1和v2在环境变量处理上有一些细节差异，先搞清楚你用的是哪个版本：

aws --version

如果是v2，注意它对配置优先级的处理有没有和v1不一样的地方——比如有时候如果~/.aws/config里的默认配置有冲突，可能会意外覆盖环境变量（不过理论上环境变量优先级更高，但还是要排查）。

2. 验证AWS_PROFILE环境变量是否真的生效了 #

首先在终端里直接输出变量，看看是不是你预期的值：

echo $AWS_PROFILE

如果输出为空或者不是你要的配置文件名，那问题出在环境变量没正确加载：

• 你是在哪个shell配置文件里设置的export AWS_PROFILE=xxx？Mac现在默认是zsh，对应~/.zshrc，如果是bash就是~/.bash_profile或~/.profile，确认文件里有没有这个配置；
• 更新CLI后有没有重启终端，或者执行source ~/.zshrc（对应你的配置文件）来重新加载环境变量？
• 有没有在当前会话里临时设置过其他AWS_PROFILE？比如之前执行过export AWS_PROFILE=other但没持久化，导致当前会话用的是临时值。

3. 检查AWS配置文件的格式和权限 #

AWS CLI的配置优先级是：命令行参数--profile > 环境变量AWS_PROFILE > 配置文件默认设置。先检查你的配置文件：

• 打开~/.aws/credentials，确认你的偏好配置文件存在，格式要对：

  [my-preferred-profile]
  aws_access_key_id = YOUR_ACCESS_KEY
  aws_secret_access_key = YOUR_SECRET_KEY
  

• 再看~/.aws/config，如果有对应profile的配置，格式要写成[profile my-preferred-profile]（注意profile前缀不能少）：

  [profile my-preferred-profile]
  region = us-west-2
  output = json
  

• 检查配置文件的权限！AWS CLI会拒绝读取权限太开放的配置文件，执行：

  ls -l ~/.aws/credentials ~/.aws/config
  

  正确权限应该是600（只有当前用户能读写），如果是644或更高，用这个命令修复：

  chmod 600 ~/.aws/credentials ~/.aws/config
  

4. 排查是否有其他环境变量干扰 #

有些其他AWS相关的环境变量可能会影响AWS_PROFILE的优先级，比如：

• AWS_DEFAULT_PROFILE：在v1里它和AWS_PROFILE作用类似，但v2里优先级可能不同；
• AWS_CONFIG_FILE或AWS_SHARED_CREDENTIALS_FILE：如果设置了这两个变量，CLI会读取指定的配置文件，而不是默认的~/.aws/下的文件。

执行下面的命令看看这些变量有没有被意外设置：

echo $AWS_DEFAULT_PROFILE $AWS_CONFIG_FILE $AWS_SHARED_CREDENTIALS_FILE

5. 用干净的终端会话测试 #

有时候终端里的缓存或者残留的环境变量会搞事情，试试这个：

• 打开一个全新的终端窗口；
• 先清除可能的临时变量：

  unset AWS_PROFILE AWS_DEFAULT_PROFILE
  

• 手动设置环境变量：

  export AWS_PROFILE=your-preferred-profile
  

• 然后执行aws sts get-caller-identity，看看返回的是不是你预期的账号信息。

6. 最后一招：重新安装AWS CLI #

如果以上都排查过还是不行，可能是更新过程中文件损坏了。卸载后重新安装试试：
对于AWS CLI v2，卸载命令：

sudo rm -rf /usr/local/aws-cli
sudo rm /usr/local/bin/aws

然后从AWS官方下载对应Mac的安装包重新安装即可。

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