使用Maven方式创建SpringBoot项目（非Spring Initializr）

阿麦

发布时间：2026-10-15| 5人浏览过

原创

由于网络原因无法直接使用Spring Initializr初始化时，本文介绍通过Maven手动搭建SpringBoot项目的完整步骤，包括配置Pom.xml依赖、创建启动类以及验证运行结果。

第1步：使用IDE创建基础Maven项目

首先在开发环境中选择创建一个普通的Maven项目模板。在创建过程中，选择JDK版本并保留空模板，随后填写项目名称、本地存储路径、Group ID及版本等信息完成初始化。

项目创建完成后，观察其基本结构，此时项目为标准的Maven结构，尚未包含SpringBoot相关功能。

第2步：改造为SpringBoot项目（修改POM配置）

将普通Maven项目转换为SpringBoot项目，核心在于修改 pom.xml 文件。请按以下顺序进行配置修改：

第1小步：继承SpringBoot Parent

为了让当前项目自动继承SpringBoot的默认依赖管理及插件配置，需在 <parent> 节点中声明父工程信息。建议自行根据需求修改版本号，示例中使用了 2.3.12.RELEASE 版本。

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>2.3.12.RELEASE</version>
    <relativePath/>
</parent>

第2小步：设置打包方式为JAR

在 <project> 节点下，明确指定该项目的打包类型为 jar，确保生成的项目是一个可执行的Jar包。

<packaging>jar</packaging>

第3小步：引入Web启动器依赖

在 <dependencies> 中添加 spring-boot-starter-web，这是构建Web应用程序的最常用启动器，包含了内嵌Tomcat和Spring MVC等核心库。

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
</dependencies>

第4小步：配置应用启动入口

在 <build> 节点下的 <plugins> 中添加 spring-boot-maven-plugin。这一步至关重要，它允许通过Maven命令生成带有正确清单信息的Fat JAR。

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <configuration>
                <mainClass>com.te.TestWebApplication</mainClass>
            </configuration>
        </plugin>
    </plugins>
</build>

第5小步：查看完整的POM结构

综合以上所有步骤，一个标准的SpringBoot Maven项目的 pom.xml 结构如下所示：

<?xml version="1.0" encoding="UTF-8"?>
<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>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.3.12.RELEASE</version>
        <relativePath/>
    </parent>

    <groupId>com.te</groupId>
    <artifactId>test</artifactId>
    <version>1.0-SNAPSHOT</version>
    <packaging>jar</packaging>

    <properties>
        <maven.compiler.source>8</maven.compiler.source>
        <maven.compiler.target>8</maven.compiler.target>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <configuration>
                    <mainClass>com.te.TestWebApplication</mainClass>
                </configuration>
            </plugin>
        </plugins>
    </build>

</project>

第3步：编写核心代码并测试运行

配置文件就绪后，需要建立SpringBoot的应用程序入口点。在相应的包路径下创建启动类，必须为其添加 @SpringBootApplication 注解并包含主方法。

package com.te;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class TestWebApplication {
    public static void main(String[] args) {
        SpringApplication.run(TestWebApplication.class, args);
    }
}

接下来，为测试服务是否正常运行，可快速创建一个简单的REST控制器。新建 TestController 类并映射一个根请求路径进行测试：

package com.te.web;

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class TestController {

    @GetMapping("/test")
    public String test() {
        return "hello world";
    }
}

完成代码编写后，点击运行按钮启动SpringBoot项目。首次启动可能需要下载依赖，启动成功后控制台会有明确的日志指示服务已就绪。