SpringBoot 项目不继承 parent 的实现方法

SpringBoot 项目不继承 parent 的实现方法

当项目需要继承自定义的 parent POM 而不能直接继承 spring-boot-starter-parent 时，可以通过以下方式实现 SpringBoot 项目的功能。

一、主要实现方式

SpringBoot 官方提供了不继承 parent 的替代方案，主要通过在 dependencyManagement 中引入 spring-boot-dependencies 来实现版本仲裁功能。

二、完整配置示例

1. 基本 POM 配置

<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0modelVersion>

    
    <parent>
        <groupId>com.yourcompanygroupId>
        <artifactId>your-company-parentartifactId>
        <version>1.0.0version>
    parent>

    <groupId>com.examplegroupId>
    <artifactId>springboot-without-parentartifactId>
    <version>1.0.0version>
    <packaging>jarpackaging>

    
    <properties>
        <java.version>1.8java.version>
        <resource.delimiter>@resource.delimiter>
        <maven.compiler.source>${java.version}maven.compiler.source>
        <maven.compiler.target>${java.version}maven.compiler.target>
        <project.build.sourceEncoding>UTF-8project.build.sourceEncoding>
        <project.reporting.outputEncoding>UTF-8project.reporting.outputEncoding>
        <spring.boot.version>2.7.0spring.boot.version>
    properties>

    
    <dependencyManagement>
        <dependencies>
            
            <dependency>
                <groupId>org.springframework.bootgroupId>
                <artifactId>spring-boot-dependenciesartifactId>
                <version>${spring.boot.version}version>
                <type>pomtype>
                <scope>importscope>
            dependency>
        dependencies>
    dependencyManagement>

    
    <dependencies>
        
        <dependency>
            <groupId>org.springframework.bootgroupId>
            <artifactId>spring-boot-starter-webartifactId>
            
        dependency>
        
        
        <dependency>
            <groupId>org.springframework.bootgroupId>
            <artifactId>spring-boot-starter-testartifactId>
            <scope>testscope>
        dependency>
    dependencies>

    
    <build>
        <plugins>
            
            <plugin>
                <groupId>org.springframework.bootgroupId>
                <artifactId>spring-boot-maven-pluginartifactId>
                <version>${spring.boot.version}version>
                <executions>
                    <execution>
                        <goals>
                            <goal>repackagegoal>
                        goals>
                    execution>
                executions>
            plugin>
        plugins>
    build>
project>

三、关键说明

1. 版本管理

• 当不继承 spring-boot-starter-parent 时，需要在 dependencyManagement 中显式引入 spring-boot-dependencies 并使用 import 范围
• 这样可以获得与继承 parent 相同的版本仲裁能力，引入 starter 依赖时无需指定版本

2. 基础配置

• 需要手动配置原本由 parent 提供的基础属性：
  • Java 版本
  • 编译参数
  • 编码格式
  • 资源分隔符等

3. 插件配置

• 必须手动配置 spring-boot-maven-plugin 插件以支持打包功能
• 该插件负责将应用打包成可执行的 JAR 文件

四、适用场景

1. 项目需要继承自定义的 parent POM（如公司内部统一的 parent）
2. 需要在多个项目间共享公司级别的 Maven 配置
3. 需要自定义或覆盖 SpringBoot 默认配置

五、注意事项

1. 确保 spring-boot-dependencies 的版本与项目使用的 SpringBoot 版本一致
2. 当需要覆盖特定依赖的版本时，可以在 properties 中定义相应的版本属性
3. 打包时确保正确配置了主类，可通过插件配置指定：

<plugin>
    <groupId>org.springframework.bootgroupId>
    <artifactId>spring-boot-maven-pluginartifactId>
    <version>${spring.boot.version}version>
    <configuration>
        <mainClass>com.example.ApplicationmainClass>
    configuration>
    <executions>
        <execution>
            <goals>
                <goal>repackagegoal>
            goals>
        execution>
    executions>
plugin>

通过以上配置，即使不直接继承 spring-boot-starter-parent，也能正常使用 SpringBoot 的所有核心功能，同时满足项目继承自定义 parent 的需求。