Spring Boot读取macOS自定义环境变量异常问题排查

这个问题我之前也碰到过，核心原因是macOS Catalina切换默认Shell后的配置文件差异，加上Spring Boot启动环境的变量继承问题，咱们一步步拆解：

为什么会出现这种情况？ #

• Shell配置文件不匹配：macOS Catalina默认把Shell从bash换成了zsh，zsh的默认加载配置是~/.zshrc，而你把环境变量写在了bash专属的~/.profile里——zsh默认不会自动加载这个文件，所以当Spring Boot在zsh环境下启动时，根本看不到这些变量。
• 启动环境的变量隔离：你用echo和普通Java程序能拿到值，大概率是因为你当前终端加载了~/.profile（比如用的是bash，或者手动source过这个文件），但如果是通过IDE（比如IntelliJ IDEA）启动Spring Boot，IDE的进程不会自动读取shell的配置文件，自然拿不到自定义变量。
• JAVA_HOME能正常读取的原因：JAVA_HOME一般是系统级配置（比如写在/etc/profile或者由Java安装程序全局注入），所有进程都能继承到，所以不受shell配置的影响。

具体解决方案 #

方案1：把变量移到zsh的配置文件里 #

最直接的方法，把环境变量迁移到zsh的默认配置文件中：

1. 打开终端，编辑~/.zshrc（没有的话直接创建）：

   open -e ~/.zshrc
   

2. 把你的变量添加进去：

   export ACCOUNT_SID="some value"
   export AUTH_TOKEN="some value"
   

3. 让配置立即生效：

   source ~/.zshrc
   

4. 重启你的Spring Boot应用（如果是IDE启动的，记得重启IDE让环境变量更新）

方案2：让zsh自动加载~/.profile #

如果你不想迁移变量，也可以让zsh主动加载bash的配置文件：

1. 编辑~/.zshrc，添加一行：

   source ~/.profile
   

2. 执行source ~/.zshrc生效，之后重启应用即可。

方案3：给IDE手动配置环境变量 #

如果不想改动shell配置，可以直接在IDE的运行配置里手动注入变量：

• 以IntelliJ IDEA为例：
  1. 打开「Run/Debug Configurations」，找到你的Spring Boot应用配置
  2. 切换到「Environment variables」选项，点击右侧的编辑按钮
  3. 添加ACCOUNT_SID=some value和AUTH_TOKEN=some value两个变量
  4. 保存配置后重新启动应用，就能正常读取变量了

方案4：设置全局环境变量（适合所有应用） #

如果希望所有应用（包括IDE、GUI程序）都能读到这些变量，可以用launchd配置全局变量：

1. 创建~/Library/LaunchAgents/com.user.environment.plist文件，写入以下内容：

   <?xml version="1.0" encoding="UTF-8"?>
   <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
   <plist version="1.0">
   <dict>
     <key>Label</key>
     <string>com.user.environment</string>
     <key>ProgramArguments</key>
     <array>
       <string>sh</string>
       <string>-c</string>
       <string>launchctl setenv ACCOUNT_SID "some value"; launchctl setenv AUTH_TOKEN "some value"</string>
     </array>
     <key>RunAtLoad</key>
     <true/>
   </dict>
   </plist>
   

2. 加载这个配置文件：

   launchctl load ~/Library/LaunchAgents/com.user.environment.plist
   

3. 重启电脑后，所有应用都会继承这些全局环境变量。

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