SpringBoot 项目创建的 5 种主流方式

步骤 4：确认项目路径并创建

• 配置 Project name（默认同 Artifact）、Project location（本地路径）。
• 点击「Finish」，IDEA 会自动下载依赖并初始化项目。

步骤 5：验证项目

• 找到自动生成的主类（如 SpringbootDemoApplication），右键「Run」。
• 控制台输出「Started SpringbootDemoApplication in X seconds」即创建成功。

3. 优点

• 可视化配置，无需手动编写 pom.xml；
• 依赖自动下载，版本与 SpringBoot 适配；
• 自动生成启动类、配置文件等核心文件。

三、方式二：Spring 官网下载压缩包创建

1. 适用场景

无 IDEA（仅用文本编辑器）、网络环境限制（需离线创建）。

2. 操作步骤

步骤 1：访问 Spring 官方脚手架

打开浏览器，访问：https://start.spring.io/（Spring Initializr 官网）。

步骤 2：配置项目信息（同方式一）

• 选择构建工具：Maven/Gradle（推荐 Maven）；
• 选择语言：Java；
• 配置 Spring Boot 版本、Group、Artifact、Java 版本等（同方式一步骤 2）；
• 点击「Add Dependencies」添加所需依赖（如 Spring Web）。

步骤 3：生成并下载压缩包

• 点击「GENERATE」按钮，浏览器自动下载 springboot-demo.zip 压缩包。

步骤 4：解压并导入 IDEA（可选）

• 解压压缩包到本地目录；
• 打开 IDEA → 「File → Open」 → 选择解压后的项目目录 → 导入。

步骤 5：验证项目

运行主启动类，控制台输出启动成功日志即可。

3. 优点

• 纯网页操作，无需本地 IDE；
• 可离线使用（下载后解压即可）；
• 依赖配置与官方脚手架一致。

四、方式三：IDEA + 阿里云脚手架创建

1. 适用场景

国内网络环境（Spring 官方地址可能卡顿）、快速创建适配阿里云的项目。

2. 操作步骤

步骤 1：打开 IDEA，新建项目

• 点击「New Project」 → 左侧选择「Spring Initializr」；
• 右侧修改 Initializr Service URL 为阿里云地址：https://start.aliyun.com；

SDK 选择对应 JDK 版本，点击「Next」。

步骤 2：配置项目基础信息

同方式一步骤 2（Group、Artifact、Java 版本等），点击「Next」。

步骤 3：选择依赖（阿里云增强）

• 阿里云脚手架提供额外适配依赖（如阿里云 OSS、Nacos、RocketMQ 等）；
• 基础依赖（如 Spring Web）与官方一致，按需勾选后点击「Next」。

步骤 4：确认路径并创建

同方式一步骤 4，点击「Finish」，IDEA 自动下载依赖。

步骤 5：验证项目

运行主启动类，启动成功即完成。

3. 核心优势

• 国内访问速度快，解决官方地址卡顿问题；
• 内置阿里云生态依赖，适配国内云服务；
• 版本适配更贴合国内开发场景。

五、方式四：阿里云官网下载压缩包创建

1. 适用场景

无 IDEA、国内网络环境、需离线创建阿里云适配项目。

2. 操作步骤

步骤 1：访问阿里云脚手架官网

打开浏览器，访问：https://start.aliyun.com/。

步骤 2：配置项目信息

• 选择构建工具（Maven/Gradle）、语言（Java）、Spring Boot 版本；
• 配置 Group、Artifact、Java 版本等基础信息；

点击「添加依赖」选择所需依赖（如 Spring Web、阿里云 Nacos 等）。

步骤 3：生成并下载压缩包

点击「生成项目」按钮，下载 xxx.zip 压缩包。

步骤 4：解压并使用

• 解压压缩包到本地目录；
• 可直接用文本编辑器编辑，或导入 IDEA（File → Open）。

步骤 5：验证项目

运行主启动类，启动成功即可。

3. 优点

• 国内访问快，依赖阿里云生态；
• 纯网页操作，无需本地 IDE；
• 适合离线开发或无 IDEA 环境。

六、方式五：普通 Maven Java 项目改造为 SpringBoot 项目

1. 适用场景

已有普通 Maven Java 项目，需升级为 SpringBoot 项目；学习 SpringBoot 核心配置原理。

2. 操作步骤

步骤 1：创建普通 Maven Java 项目（IDEA）

• 打开 IDEA → 「New Project」 → 左侧选择「Maven」；
• 配置 SDK（JDK），点击「Next」；
• 配置 Group、Artifact、Version，点击「Next」；

确认路径后点击「Finish」，生成空 Maven 项目。

步骤 2：修改 pom.xml，添加 SpringBoot 核心依赖

替换原 pom.xml 内容为以下模板（以 SpringBoot 2.7.x 为例）：

<?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>
  <!-- SpringBoot 父工程（核心，统一依赖版本） -->
  <parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>2.7.15</version>
    <!-- 稳定版本，可替换为 3.x -->
    <relativePath/>
  </parent>
  <!-- 基础配置 -->
  <groupId>com.example</groupId>
  <artifactId>maven-to-springboot</artifactId>
  <version>0.0.1-SNAPSHOT</version>
  <name>maven-to-springboot</name>
  <description>Convert Maven project to SpringBoot</description>
  <!-- JDK 版本 -->
  <properties>
    <java.version>8</java.version>
  </properties>
  <!-- 核心依赖：Spring Web（web 场景） -->
  <dependencies>
    <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <!-- 测试依赖（可选） -->
    <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-test</artifactId>
      <scope>test</scope>
    </dependency>
  </dependencies>
  <!-- SpringBoot 打包插件（必须，否则无法运行 jar 包） -->
  <build>
    <plugins>
      <plugin>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-maven-plugin</artifactId>
        <version>2.7.15</version>
        <!-- 与父工程版本一致 -->
        <executions>
          <execution>
            <goals>
              <goal>repackage</goal>
            </goals>
          </execution>
        </executions>
      </plugin>
    </plugins>
  </build>
</project>

步骤 3：创建 SpringBoot 主启动类

• 在 src/main/java 下创建包（如 com.example）；
• 在包下创建主启动类（如 MavenToSpringBootApplication）：

package com.example;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

/**
 * SpringBoot 主启动类
 * @SpringBootApplication：核心注解，标识 SpringBoot 应用
 */
@SpringBootApplication
public class MavenToSpringBootApplication {
    public static void main(String[] args) {
        // 启动 SpringBoot 应用
        SpringApplication.run(MavenToSpringBootApplication.class, args);
    }
}

步骤 4：验证项目

运行主启动类的 main 方法；

3. 核心注意事项

• 必须添加 spring-boot-starter-parent 父工程（统一依赖版本）；
• 必须添加 spring-boot-maven-plugin 打包插件（否则 jar 包无法独立运行）；
• 主启动类需放在所有业务类的上层包（或同层），否则需手动配置扫描路径；
• @SpringBootApplication 注解是核心，整合了 @Configuration、@ComponentScan、@EnableAutoConfiguration。

七、五种方式对比总结

八、常见问题解决

1. 依赖下载失败：
   • 检查 Maven 镜像（推荐配置阿里云镜像）；
   • 确认 SpringBoot 版本与 JDK 兼容（3.x 需 JDK17+，2.x 支持 JDK8+）。
2. 主启动类运行报错「找不到主类」：
   • 检查 spring-boot-maven-plugin 插件是否添加；
   • 确认主类包路径与 @SpringBootApplication 扫描范围一致。
3. 阿里云脚手架访问失败：
   • 检查网络，或更换浏览器重试；
   • 确认地址为 https://start.aliyun.com（非 http）。
4. Maven 改造后接口访问 404：
   • 检查 Controller 注解（@RestController/@Controller）；
   • 确认主启动类包路径包含 Controller 所在包。