Homebrew切换Maven版本后mvn仍显示旧版本原因排查

Homebrew的link操作本身没有问题，版本不生效是两类常见系统配置问题导致的：

• PATH环境变量优先级问题
  基本都是之前手动安装过3.5.4版本Maven留下的配置：要么在shell配置文件（~/.zshrc/~/.bash_profile/~/.bashrc）里硬写了旧版本的MAVEN_HOME，把旧版本的bin目录加到了PATH靠前的位置；要么在全局路径配置（/etc/paths、/etc/paths.d/下的自定义配置）里加过旧Maven的路径。终端执行命令时会严格按照PATH的顺序从前往后查找可执行文件，只要旧版本路径排在Homebrew软链路径（/opt/homebrew/bin）前面，就会优先命中旧版mvn，根本读不到brew link生成的3.8.6版本软链。
• Shell命令缓存未刷新
  zsh、bash等常用shell都会缓存已执行过的命令路径，减少重复查找的开销。如果切换版本之前执行过mvn相关命令，shell会把旧版mvn的路径存在缓存里，切换后不会主动重新遍历PATH查找新路径，就会一直调用缓存里的旧版本。

1. 先定位当前命中的mvn实际路径，执行命令：

which mvn

• 如果返回结果不是/opt/homebrew/bin/mvn，就是PATH优先级问题：
  打开当前shell对应的配置文件（Mac默认用zsh，对应文件为~/.zshrc），找到里面手动配置的旧版Maven相关的MAVEN_HOME、PATH追加旧maven bin目录的配置行，全部删除后保存，执行source ~/.zshrc让配置立即生效。如果返回的旧路径在系统级目录下，就检查/etc/paths和/etc/paths.d/下的配置文件，删掉旧Maven的路径配置即可。
• 如果返回结果确实是/opt/homebrew/bin/mvn，就是shell缓存问题：
  执行命令清空shell的命令路径缓存：

  hash -r
  

2. 操作完成后重新执行mvn --version，即可看到正确的3.8.6版本。

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