MacOS更新OS/Brew后Lombok @Slf4j注解Maven编译失败问题

针对MacOS/Homebrew更新后，Lombok @Slf4j注解在IDE正常但Maven命令行构建失败的问题，结合Java 23与Maven环境，按以下步骤排查修复：

1. 升级Lombok至兼容Java 23的版本 #

Java 23属于较新的版本，旧版Lombok（1.18.30以下）对其注解支持不完善。直接在POM中升级Lombok到最新稳定版：

<dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
    <version>1.18.32</version> <!-- 或更高稳定版 -->
    <scope>provided</scope>
</dependency>

2. 强制Maven配置注解处理器 #

IDE通常会自动识别Lombok的注解处理，但Maven命令行需要明确配置。修改maven-compiler-plugin，添加注解处理器路径：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.12.1</version> <!-- 确保插件版本支持Java 23 -->
            <configuration>
                <source>23</source>
                <target>23</target>
                <encoding>UTF-8</encoding>
                <!-- 明确指定Lombok作为注解处理器 -->
                <annotationProcessorPaths>
                    <path>
                        <groupId>org.projectlombok</groupId>
                        <artifactId>lombok</artifactId>
                        <version>1.18.32</version> <!-- 和依赖版本一致 -->
                    </path>
                </annotationProcessorPaths>
            </configuration>
        </plugin>
    </plugins>
</build>

若之前使用lombok-maven-plugin，需同步升级其版本，或直接采用上述annotationProcessorPaths配置更可靠。

3. 验证Maven命令行的Java环境 #

Homebrew更新可能修改系统默认Java版本，确认Maven使用的JDK是否为Java 23：

mvn -v

若输出的Java版本不符，可在POM中强制指定JDK路径：

<!-- 在maven-compiler-plugin配置中添加 -->
<configuration>
    <!-- 其他配置... -->
    <fork>true</fork>
    <executable>/Library/Java/JavaVirtualMachines/jdk-23.jdk/Contents/Home/bin/javac</executable>
</configuration>

4. 清理Maven本地缓存 #

Homebrew更新可能导致本地仓库的Lombok依赖损坏，执行清理并重新下载依赖：

mvn clean install -U

额外排查点 #

• 检查全局Maven设置（~/.m2/settings.xml）是否存在禁用注解处理的配置，比如maven.compiler.annotationProcessors被清空或覆盖。
• 确认代码中导入的是lombok.extern.slf4j.Slf4j，避免误引入其他包下的@Slf4j注解。

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