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

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

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

一、主要实现方式

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

二、完整配置示例

1. 基本 POM 配置

xml 复制代码
<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.0</modelVersion>

    <!-- 继承自定义 parent POM -->
    <parent>
        <groupId>com.yourcompany</groupId>
        <artifactId>your-company-parent</artifactId>
        <version>1.0.0</version>
    </parent>

    <groupId>com.example</groupId>
    <artifactId>springboot-without-parent</artifactId>
    <version>1.0.0</version>
    <packaging>jar</packaging>

    <!-- 手动配置基础属性(原本由 spring-boot-starter-parent 提供) -->
    <properties>
        <java.version>1.8</java.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-8</project.build.sourceEncoding>
        <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
        <spring.boot.version>2.7.0</spring.boot.version>
    </properties>

    <!-- 引入 Spring Boot 依赖管理 -->
    <dependencyManagement>
        <dependencies>
            <!-- Spring Boot 依赖管理,提供版本仲裁 -->
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-dependencies</artifactId>
                <version>${spring.boot.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>

    <!-- 项目依赖 -->
    <dependencies>
        <!-- Spring Boot Web 依赖 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
            <!-- 不需要指定版本,由 dependencyManagement 中的 spring-boot-dependencies 控制 -->
        </dependency>
        
        <!-- Spring Boot 测试依赖 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>

    <!-- 配置 Maven 插件 -->
    <build>
        <plugins>
            <!-- Spring Boot Maven 插件,用于打包可执行 JAR -->
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <version>${spring.boot.version}</version>
                <executions>
                    <execution>
                        <goals>
                            <goal>repackage</goal>
                        </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. 打包时确保正确配置了主类,可通过插件配置指定:
xml 复制代码
<plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
    <version>${spring.boot.version}</version>
    <configuration>
        <mainClass>com.example.Application</mainClass>
    </configuration>
    <executions>
        <execution>
            <goals>
                <goal>repackage</goal>
            </goals>
        </execution>
    </executions>
</plugin>

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

相关推荐
货拉拉技术4 分钟前
AI Agent 如何进入实时交易系统:货拉拉的三个实践与一套工程方法论
后端·架构·agent
我是谁的程序员6 分钟前
iOS 性能分析在 Windows 上怎么做,用 KXBuild 的 kxdevice 替代 Instruments
后端·ios
华为云开发者联盟12 分钟前
TaurusDB 慢 SQL 智能诊断:用大模型辅助调优
后端
ServBay16 分钟前
AI编程越来越强,为什么软件漏洞却是一个没少?MySQL又爆高危漏洞了
后端·mysql
黑十18 分钟前
FDE 怎么快速搭一个可演示页面?最小前端方案
java·大数据·前端·数据库·人工智能
季风113237 分钟前
10.对象关系行为
后端
神明不懂浪漫39 分钟前
【第八章】多线程(一)
java·开发语言·经验分享·笔记
tann1 小时前
Environment类
后端
鲸鹏芯海微电子科技上海有限公司1 小时前
手机直连卫星,射频前端到底要解决什么?
前端·后端
开心就好20251 小时前
通配符 Bundle ID 和精确 Bundle ID 怎么选,推送、iCloud 能不能用通配符
后端·ios