使用 Spring Boot BOM 替代 Parent 的方法_技术教程

本文档旨在指导开发者如何在Maven项目中利用Bill of Materials (BOM) 来管理依赖，以替代传统的继承 Spring Boot Parent POM 的方式。我们将深入探讨BOM的配置和使用，并提供一个实际案例，帮助您解决依赖管理中的常见问题，确保项目能够正确下载和使用所需的依赖项。

理解 Maven BOM (Bill of Materials)

Maven BOM (Bill of Materials) 是一种特殊的 POM 文件，它定义了一组依赖项的版本信息，但不引入实际的依赖。通过在 dependencyManagement 节中导入 BOM，您可以集中管理项目的依赖版本，避免版本冲突，并简化依赖声明。使用BOM，你无需为每个依赖显式指定版本，Maven 会自动从 BOM 中获取。

如何使用 Spring Boot BOM

要使用 Spring Boot BOM 替代 parent POM，你需要执行以下步骤：

移除 parent POM： 从 pom.xml 文件中移除标签。

添加 BOM 依赖： 在 dependencyManagement 节中，添加 Spring Boot BOM 作为依赖项，并设置 scope 为 import 和 type 为 pom。


    
        
            org.springframework.boot
            spring-boot-dependencies
            ${spring-boot.version}
            pom
            import

声明依赖： 在 dependencies 节中，声明你需要的 Spring Boot 依赖项，无需指定版本。Maven 会自动从 Spring Boot BOM 中解析版本。
```
    
        org.springframework.boot
        spring-boot-starter-web
    
```

示例：使用 Spring Boot BOM 的 pom.xml 文件

下面是一个完整的 pom.xml 文件的示例，展示了如何使用 Spring Boot BOM 来管理依赖：



    4.0.0

    org.example
    bom-experiments
    1.0-SNAPSHOT

    
        11
        11
        UTF-8
        5.7.2
        2.18.16
        4.8.0
        2.7.5
        5.3.24

        1.18.24
        3.10.1
        3.0.0-M7
        ${junit-jupiter.version}
        1.9.0

        
        4.9.0
    

    
        
            
                org.springframework
                spring-framework-bom
                ${org.springframework.version}
                pom
                import
            
            
                org.springframework.boot
                spring-boot-dependencies
                ${org.springframework.boot.version}
                pom
                import
            
            
                software.amazon.awssdk
                bom
                ${aws-sdk.version}
                pom
                import
            
            
                org.junit
                junit-bom
                ${junit-jupiter.version}
                pom
                import
            
            
                org.mockito
                mockito-bom
                ${mockito.version}
                pom
                import
            
        
    

    
        
            org.springframework.boot
            spring-boot-starter-web
        

        
            org.springframework.boot
            spring-boot-starter-actuator
        

        
        
            software.amazon.awssdk
            secretsmanager
        

        
            software.amazon.awssdk
            ssm
        

        
            software.amazon.awssdk
            sts
        


        
        
            org.projectlombok
            lombok
            ${lombok.version}
            provided
        

        
        
            org.junit.jupiter
            junit-jupiter-engine
            test
        
        
            org.springframework.boot
            spring-boot-starter-test
            test
        
        
            org.mockito
            mockito-inline
            test
        
        
            org.mockito
            mockito-junit-jupiter
            test
        
        
            org.junit.jupiter
            junit-jupiter-params
            test
        
        
            org.junit.jupiter
            junit-jupiter-api
            test
        
    

    
        bom-experiments
        ${project.basedir}/src/main
        ${project.basedir}/src/test
        
            
                org.apache.maven.plugins
                maven-surefire-plugin
                ${maven-surefire-plugin.version}
            

            
                org.apache.maven.plugins
                maven-compiler-plugin
                ${maven-compiler-plugin.version}
            
            
                org.springframework.boot
                spring-boot-maven-plugin
                ${org.springframework.boot.version}

注意：

确保 spring-boot.version 属性与你想要使用的 Spring Boot 版本一致。
必须指向正确的源代码目录，通常是 ${project.basedir}/src/main。如果指向错误的位置，会导致编译错误。

解决依赖未下载的问题

如果在添加 BOM 后，仍然遇到依赖未正确下载的问题，可以尝试以下方法：

检查 dependencyManagement 配置： 确保 BOM 依赖项的 type 设置为 pom，scope 设置为 import。
清理和重新构建项目： 运行 mvn clean install 命令清理项目并重新构建。
检查
Maven 仓库：确保 Maven 能够访问所需的仓库，并且依赖项已存在于仓库中。
检查 IDE 配置： 确保你的 IDE (如 IntelliJ IDEA 或 Eclipse) 已正确配置 Maven，并且能够解析依赖项。

总结

使用 Spring Boot BOM 可以有效地管理项目的依赖版本，避免版本冲突，并简化依赖声明。通过正确配置 dependencyManagement 节，并确保源代码目录设置正确，你可以成功地使用 BOM 替代 parent POM。如果在使用过程中遇到问题，请仔细检查配置，并尝试清理和重新构建项目。