本文详解 spring-boot-maven-plugin 中 的真实作用——它不移除依赖，而是防止 Lombok 等仅需编译期存在的库被错误打包进最终可执行 JAR；同时厘清其与 （用于解决传递依赖冲突）的本质区别。

本文详解 `spring-boot-maven-plugin` 中 `` 的真实作用——它不移除依赖，而是防止 lombok 等仅需编译期存在的库被错误打包进最终可执行 jar；同时厘清其与 ``（用于解决传递依赖冲突）的本质区别。

在 Spring Boot 项目中，当你引入 Lombok 时，常会发现 pom.xml 中自动出现如下配置：

<plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
    <configuration>
        <excludes>
            <exclude>
                <groupId>org.projectlombok</groupId>
                <artifactId>lombok</artifactId>
            </exclude>
        </excludes>
    </configuration>
</plugin>

⚠️ 关键澄清：这不是 Maven 依赖排除（），也不是禁用 Lombok 功能——它仅影响打包阶段（package 生命周期）。

✅ 的真实语义：控制「打包内容」，而非「依赖解析」

spring-boot-maven-plugin 的 配置属于 构建插件级排除，其作用是：
? 在执行 mvn package 构建可执行 JAR/WAR 时，跳过将指定依赖（如 lombok）复制到 BOOT-INF/lib/ 目录中；
? 但该依赖仍完整保留在编译类路径（compile scope）中，确保 @Getter、@Data 等注解能被 lombok 注解处理器正常处理；
? 最终生成的 JAR 不含 lombok.jar，既减小体积，又避免运行时因重复加载或版本冲突引发的 NoClassDefFoundError 或 IncompatibleClassChangeError。

✅ 正确的 Lombok 声明方式（推荐 optional=true）：

<dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
    <optional>true</optional> <!-- 明确声明：不传递给下游模块 -->
</dependency>

optional=true 进一步强化语义：Lombok 仅对当前模块编译必需，不应成为其他模块的间接依赖。

❌ 常见误解：混淆 与

配置位置	所属标签	作用域	典型用途
	内部（spring-boot-maven-plugin）	构建插件行为	控制最终打包产物中是否包含某依赖（如排除 Lombok、log4j2-api）
	内部	依赖解析过程	解决传递依赖冲突（如 A 和 B 都依赖不同版本的 snakeyaml，需排除其中一个）

例如，若 dependency-a 和 dependency-b 均传递引入 snakeyaml，应使用 统一收敛版本：

<dependency>
    <groupId>com.example</groupId>
    <artifactId>dependency-b</artifactId>
    <exclusions>
        <exclude>
            <groupId>org.yaml</groupId>
            <artifactId>snakeyaml</artifactId>
        </exclude>
    </exclusions>
</dependency>
<!-- 然后显式声明所需版本 -->
<dependency>
    <groupId>org.yaml</groupId>
    <artifactId>snakeyaml</artifactId>
    <version>2.2</version> <!-- 覆盖所有传递引用 -->
</dependency>

而 绝不应 为 snakeyaml 在 spring-boot-maven-plugin 中添加 —— 因为它是运行时必需的依赖（如 YAML 配置解析），排除后将导致 ApplicationContext 启动失败。

✅ 最佳实践总结

1. Lombok 等纯编译期工具（如 mapstruct-processor、spring-boot-configuration-processor）
   → 保持 （由 Spring Boot Starter 自动配置或手动添加），并设 optional=true。

2. 运行时必需的传递依赖（如 snakeyaml、jackson-databind、slf4j-api）
   → 禁止 在 spring-boot-maven-plugin 中 ；应通过 （如 2.2>）或直接声明 dependency 方式统一版本。

3. 验证是否生效：
   执行 mvn clean package 后检查 target/*.jar：

   jar -tf target/myapp-0.0.1-SNAPSHOT.jar | grep lombok
   # 应无输出 → 表明已成功排除

? 提示：Spring Boot 3.x+ 默认启用 spring-boot-maven-plugin 的智能排除逻辑，Lombok、spring-boot-devtools 等常见编译/开发期依赖会被自动识别并排除，无需手动配置 —— 除非你使用了非标准坐标或自定义插件配置。

遵循以上原则，即可精准控制依赖生命周期，兼顾编译效率、运行稳定与包体积优化。