brew安装Maven报错：不支持macOS 12

Question

在 macOS 12 系统上使用 Homebrew 安装 Maven 时，部分用户遇到“Error: maven: macOS 12 is not supported”错误。该问题通常源于 Homebrew 公式中对特定 macOS 版本的兼容性限制，或 Java 环境不匹配（如仅安装了 JRE 或版本过低）。尽管 macOS 12 已发布较长时间，某些旧版公式仍未更新适配。解决方案包括：升级 Homebrew 至最新版本、手动更新本地 formula，或改用 SDKMAN 安装 Maven。同时需确认已安装支持的 JDK 版本（如 OpenJDK 11 或 17），并确保系统完整性设置未阻止命令行工具运行。

Answer 1

1. 问题背景与现象描述

在 macOS 12（Monterey）系统上使用 Homebrew 安装 Apache Maven 时，部分用户会遇到如下错误提示：

Error: maven: macOS 12 is not supported

该错误并非源于操作系统本身不兼容 Maven，而是由 Homebrew 的 formula（软件包定义脚本）中对特定 macOS 版本的硬性限制所致。尤其在某些旧版本的 Homebrew 核心仓库中，maven.rb 公式可能仍保留了对 macOS 11 及以下版本的支持判断逻辑，导致在 macOS 12 上触发版本拦截机制。

2. 常见原因分析

• Homebrew 公式未更新：某些旧版 formula 显式检查 macOS 版本号，并拒绝在 12.x 上运行。
• Java 环境缺失或不匹配：Maven 依赖 JDK 而非 JRE，若仅安装了运行时环境或 JDK 版本低于 8，则无法启动。
• 系统完整性保护（SIP）或命令行工具权限问题：macOS 安全策略可能阻止 brew 执行某些操作。
• 本地缓存公式陈旧：即使远程仓库已更新，本地仍使用过期的 formula 文件。

3. 深度排查流程图

graph TD
    A[开始安装 Maven] --> B{Homebrew 是否最新?}
    B -- 否 --> C[执行 brew update]
    B -- 是 --> D{Java 环境是否满足?}
    C --> D
    D -- 否 --> E[安装 OpenJDK 11/17]
    D -- 是 --> F{是否报 'macOS 12 not supported'?}
    E --> F
    F -- 是 --> G[手动更新 maven formula 或切换 SDKMAN]
    F -- No --> H[成功安装]
    G --> I[验证 MAVEN_HOME 与 PATH]
    I --> J[完成]
    

4. 解决方案详述

1. 升级 Homebrew 至最新版本
   执行以下命令确保所有组件为最新：

brew update && brew upgrade

这将同步最新的 formula 定义，包括已修复 macOS 12 支持的 maven 包。

1. 验证并安装合适的 JDK
   检查当前 Java 版本：

java -version

推荐通过 Homebrew 安装 OpenJDK 11 或 17：

brew install openjdk@11
# 或
brew install openjdk@17

安装后配置符号链接：

sudo ln -sfn /opt/homebrew/opt/openjdk@17/libexec/openjdk.jdk /Library/Java/JavaVirtualMachines/openjdk-17.jdk

1. 手动更新本地 Maven Formula（高级）
   若问题依旧，可手动替换 formula 文件：

cd $(brew --repo homebrew/core)
git fetch origin
git checkout origin/master Library/Formula/maven.rb

1. 使用 SDKMAN 替代安装方案
   SDKMAN 是 JVM 工具的标准管理器，支持跨平台安装 Maven：

curl -s "https://get.sdkman.io" | bash
source "$HOME/.sdkman/bin/sdkman-init.sh"
sdk install maven

5. 验证与环境配置对比表

方式	命令	优点	缺点	适用场景
Homebrew（更新后）	brew install maven	集成系统、易于管理	受 formula 限制	日常开发，偏好 brew 管理
SDKMAN	sdk install maven	多版本共存，更新及时	需额外学习工具	JVM 生态重度用户
手动下载解压	tar -xzf apache-maven-*.tar.gz	完全可控，无需依赖	需手动维护 PATH	企业内网或受限环境

6. 进阶建议与最佳实践

对于具备 5 年以上经验的开发者，建议建立统一的开发环境管理体系：

• 使用 direnv + asdf 实现项目级 JDK/Maven 版本控制。
• 结合 CI/CD 流程模拟本地环境，避免“在我机器上能跑”问题。
• 定期审计 Homebrew 安装包状态：brew outdated 与 brew doctor。
• 启用 Zsh 插件自动加载 JAVA_HOME，例如 zsh-java-plugin。
• 记录环境快照，便于团队协作和故障复现。