Mac zsh执行mongod报command not found无法使用MongoDB

在MacBook的zsh终端执行MongoDB启动命令：
mongod --config /usr/local/etc/mongod.conf
终端返回报错：
zsh: command not found: mongod

• 为什么和其他用户按完全相同的教程操作，只有自己出现报错？
  公开教程基本都基于作者本人的使用环境编写，不会覆盖所有设备的特殊配置，哪怕操作步骤完全一致，只要本地环境和教程默认环境有差异，就会出现别人操作正常、你这边报错的情况。常见的差异点包括：

  • 设备为Apple Silicon（M1/M2/M3系列）芯片，Homebrew默认安装路径和Intel芯片设备不一致
  • 本地zsh配置文件未正确写入MongoDB可执行文件路径，或修改配置后未重载生效
  • 安装过程中出现静默失败，MongoDB可执行文件没有被正确链接到系统全局路径
  • 本地存在多版本MongoDB，路径冲突导致系统无法识别目标命令
  • 手动安装时自定义了解压路径，和教程默认路径不匹配

• 触发该报错的根本原因是什么？
  zsh终端的环境变量PATH中没有包含mongod可执行文件所在的目录。终端接收到执行mongod的指令后，会遍历PATH中记录的所有目录查找同名可执行文件，遍历完所有路径都没找到目标文件时，就会抛出command not found报错。这个报错和MongoDB服务本身是否正常、配置文件是否正确没有直接关联，属于系统路径识别层面的问题。

• 可通过哪些操作修复该问题？
  按以下顺序操作即可排查修复：

  1. 确认本地mongod文件的真实存放路径
     • Intel芯片Mac通过Homebrew安装的默认路径为/usr/local/Cellar/mongodb-community/<对应版本号>/bin/
     • Apple Silicon芯片Mac通过Homebrew安装的默认路径为/opt/homebrew/Cellar/mongodb-community/<对应版本号>/bin/
     • 手动压缩包安装的路径为自行选择的解压目录下的bin文件夹
       找不到路径可以直接执行全局搜索命令定位：
       sudo find / -name "mongod" 2>/dev/null
  2. 将查到的bin目录添加到zsh环境变量
     执行命令打开zsh配置文件：
     open -e ~/.zshrc
     在文件末尾追加路径配置，替换为你实际查到的bin目录地址即可。如果是Homebrew安装的场景，直接追加Homebrew的全局bin路径更方便后续版本升级，不需要每次换版本改配置：
     • Apple Silicon设备追加：export PATH="/opt/homebrew/bin:$PATH"
     • Intel芯片设备追加：export PATH="/usr/local/bin:$PATH"
  3. 让配置生效
     保存.zshrc文件后，终端执行命令重载配置：
     source ~/.zshrc
  4. 验证修复结果
     执行mongod --version，如果能正常返回版本号信息，说明路径配置生效，再执行原启动命令即可正常运行。
     *如果完成以上操作还是报错，执行命令重建Homebrew的软链接即可：
     brew unlink mongodb-community && brew link mongodb-community

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