IntelliJ中Maven构建无法读取Mac系统环境变量问题排查

核心原因分析 #

1. Shell配置文件加载逻辑变化
   若你的系统默认Shell已从Bash切换为Zsh（比如macOS Catalina及以上版本默认用Zsh），~/.bash_profile仅在Bash登录Shell时加载，Zsh默认读取的是~/.zshrc。首次打开终端或IntelliJ时，默认Shell未加载~/.bash_profile，所以环境变量不存在；手动source ~/.bash_profile只是临时在当前Shell会话生效，无法传递给IDE的Maven进程。

2. GUI程序环境变量继承限制
   IntelliJ作为GUI程序，在macOS下由launchd启动，不会自动加载Shell的配置文件（比如~/.bash_profile或~/.zshrc）。因此即使你在终端里source了配置，IDE自身的环境中依然没有这些变量，Maven进程作为IDE的子进程自然也读取不到。

3. Maven settings.xml变量读取机制
   Maven中${env.XXX}读取的是JVM进程的环境变量，而非当前Shell会话的变量。如果IDE启动时未携带这些环境变量，无论你在终端怎么操作，Maven都无法获取到。

4. Settings.xml路径不匹配
   你提到硬编码值也无效，大概率是IntelliJ使用的不是你修改的~/.m2/settings.xml。IDE可能配置了自定义的settings文件路径，导致你的修改未生效。

具体解决方案 #

• 统一Shell配置文件
  执行echo $SHELL确认默认Shell：

  • 若为Zsh：将export ARTIFACTORY_USER="..."和export ARTIFACTORY_API_TOKEN="..."复制到~/.zshrc，或者在~/.zshrc末尾添加source ~/.bash_profile，确保Zsh启动时加载Bash的配置。
  • 若仍用Bash：检查~/.bashrc是否存在，若存在需要在~/.bash_profile中添加source ~/.bashrc，确保非登录Shell也能加载变量。

• 让IntelliJ继承环境变量
  两种方式：

  1. 从Shell启动IDE：打开Bash终端，执行source ~/.bash_profile后，再用open -a "IntelliJ IDEA"启动IDE，此时IDE会继承终端的环境变量。
  2. 在IDE中手动配置：打开IntelliJ的Settings → Build, Execution, Deployment → Build Tools → Maven → Runner，在Environment variables中添加ARTIFACTORY_USER=xxx和ARTIFACTORY_API_TOKEN=xxx。

• 确认Settings.xml路径
  打开IntelliJ的Settings → Build, Execution, Deployment → Build Tools → Maven，检查User settings file指向的路径是否为你修改的~/.m2/settings.xml，若不是则调整为正确路径，或者将修改同步到IDE指定的settings文件中。

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