macOS Catalina启动Terminal报:mountain_lion错误 无mongodb求排查
终端启动时报
Error: unknown or unsupported macOS version: :mountain_lion 排查与解决 以下方案针对未配置过MongoDB环境、运行macOS Catalina 10.15.7的场景设计,不涉及MongoDB相关排查逻辑。
第一步:先定位报错触发源
打开终端就自动弹出报错,说明问题出在shell启动阶段自动执行的脚本里,并非手动执行命令才触发,可以按下面的方法快速定位:
- 打开全新终端窗口,仔细看报错前后的关联输出:多数情况下报错行的上下相邻行会明确显示触发错误的脚本路径、执行的命令内容,比如会标注是执行哪段brew相关初始化代码时弹出的错误
- 如果报错没有附带上下文,可以用不加载任何自定义配置的模式打开终端验证:按住Shift键启动Terminal,或者执行
open -a Terminal --env=BASH_ENV=/dev/null,这种模式下如果不再弹出报错,就能100%确定是shell配置文件内的启动逻辑触发的问题。
核心常见原因
这个报错和是否配置过MongoDB没有直接关联,网上的关联结论只是巧合——多数同类报错的本质都是Homebrew版本过旧导致的:
- 旧版本Homebrew的系统版本识别逻辑存在bug,在macOS Catalina及以上系统上会错误把当前系统版本识别为早已停止支持的mountain_lion,只要shell启动时自动执行brew的初始化代码,就会弹出这个报错。之前网传的MongoDB相关报错,只是那些用户刚好在brew安装MongoDB的操作流程中碰到了旧brew的bug,不是MongoDB本身触发的问题。
- 次要原因是shell配置文件里残留了多年前安装的、已停止维护的工具初始化脚本:这类脚本内部硬编码了macOS版本判断规则,碰到Catalina系统时就会触发版本识别错误。
检查shell配置文件的重点关注项
所有常见的shell配置文件(.profile、.bashrc、.bash_profile、.zshrc、.zprofile)都存放在用户主目录下,执行 cat ~/.bash_profile ~/.bashrc ~/.profile ~/.zprofile ~/.zshrc 可以一次性输出所有文件的内容,不需要逐个打开查看。检查时重点关注以下内容:
- 所有和
brew、homebrew相关的自动执行语句:比如eval "$(/usr/local/bin/brew shellenv)"这类初始化代码,是这类报错最高发的触发源 - 硬编码了macOS版本判断的自定义脚本行:比如类似
if [ "$(sw_vers -productVersion)" = "10.15" ]; then 执行xxx命令这类自己编写或第三方工具写入的版本匹配规则 - 多年前安装的版本管理工具的初始化代码:比如旧版nvm、rbenv、pyenv、conda的启动注入代码,这类老版本工具已经停止维护,版本识别逻辑不适配新系统时就会触发报错
- 记忆模糊、不确定来源的零散执行语句:这类通常是多年前为了安装某款软件临时加的启动逻辑,放久了容易成为隐蔽的报错来源
分步解决操作
- 优先更新Homebrew到适配Catalina的稳定版本:手动执行
/usr/local/bin/brew update-reset,完成后关闭所有终端窗口重新打开测试,绝大多数这类报错在这一步就能解决 - 如果更新brew后报错仍然存在,逐行注释配置文件中的启动语句:打开对应的配置文件,从最后一行往前逐行注释内容,每次保存后重启终端测试,找到触发报错的那行后,删除旧代码或替换为对应工具的新版初始化逻辑即可
- 如果始终定位不到触发源,可以备份现有配置文件后,删掉所有非系统自动生成的配置行,重新生成干净的shell配置,重启终端即可消除报错。
内容的提问来源于stack exchange,提问作者hhs
相关产品推荐
相关产品推荐

