第 5 章：IDEA 创建 SpringBoot3 Maven 项目

第 5 章：IDEA 创建 SpringBoot3 Maven 项目

目标：使用 IDEA 创建 SpringBoot3 + Maven 项目，确认 JDK 版本，拉取依赖，启动项目，访问默认接口
前置：JDK17、IDEA、Maven 阿里云镜像已经配置完成

5.1 新建项目

1. IDEA 首页点击 New Project
2. 左侧选择 Spring Initializr（Spring 官方脚手架，推荐）

如果你的 IDEA 社区版没有 Spring Initializr 插件：可以去 start.spring.io 网页生成项目压缩包，导入 IDEA，文末会补充网页生成方式。

脚手架参数填写（重点，不要填错）

• Service URL：https://start.spring.io（默认即可）
• Project：Maven Project
• Language：Java
• Spring Boot Version：3.2.x（不要选 3.3+，新版本部分依赖变化，学习稳定版 3.2.x）
• Group：com.demo（组织包名，反向域名，自定义）
• Artifact：springboot-demo（项目名称）
• Name：springboot-demo
• Description：SpringBoot3 demo project
• Package name：com.demo.springbootdemo（自动生成）
• Packaging：Jar（打包成 jar，后面部署用）
• Java：17 ⚠️ 必须选 17！SpringBoot3 最低 JDK17

勾选依赖（这一章只勾选基础依赖，后面章节逐步加 MyBatis、Redis）

✅ 勾选：

• Spring Web（web 开发，写接口必备）

先只选这一个！其他依赖（MySQL、Redis）后续手动在 pom.xml 引入，方便理解。

点击 Create，等待 IDEA 自动下载项目骨架和 Maven 依赖。

5.2 项目目录结构说明（零基础看懂）

springboot-demo
├── src
│   ├── main
│   │   ├── java
│   │   │   └── com/demo/springbootdemo
│   │   │       └── SpringbootDemoApplication.java  # 项目启动类！核心
│   │   └── resources
│   │       ├── static    # 静态资源
│   │       ├── templates # 模板页面
│   │       └── application.properties  # 默认配置文件，我们换成yml
│   └── test # 单元测试目录
└── pom.xml  # Maven核心配置文件，管理所有依赖

操作 1：把配置文件改为 yml（推荐格式，可读性更高）

1. 删除 resources/application.properties
2. 新建文件：application.yml

# application.yml
# 服务端口
server:
  port: 8080
# 项目上下文路径（不配置默认 /）
  servlet:
    context-path: /

5.3 查看 pom.xml 确认依赖

打开 pom.xml，检查 spring-boot-starter-web 依赖，大概长这样：

<?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 https://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>3.2.5</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <groupId>com.demo</groupId>
    <artifactId>springboot-demo</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>springboot-demo</name>
    <description>SpringBoot3 demo project</description>

    <properties>
        <java.version>17</java.version>
    </properties>

    <dependencies>
        <!-- Spring Web 接口开发依赖 -->
        <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>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>
</project>

IDEA 右侧 Maven 面板，点击刷新按钮，等待所有依赖下载完成。右下角进度条跑完，没有红色报错。

5.4 编写第一个测试接口 HelloController

在包 com.demo.springbootdemo 下面新建包 controller
controller 包内新建类 HelloController.java

package com.demo.springbootdemo.controller;

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

// RestController：标记这是接口控制器，返回JSON
@RestController
public class HelloController {

    // GetMapping：接收GET请求
    @GetMapping("/hello")
    public String hello() {
        return "Hello SpringBoot3 !";
    }
}

5.5 启动项目

打开启动类 SpringbootDemoApplication.java

package com.demo.springbootdemo;

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

@SpringBootApplication
public class SpringbootDemoApplication {

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

}

右键 main 方法 → Run ‘SpringbootDemoApplication’

✅ 启动成功标志：控制台输出

Tomcat started on port 8080 (http) with context path '/'
Started SpringbootDemoApplication in xxx seconds

5.6 测试接口（Postman）

打开 Postman，新建 GET 请求
URL：http://localhost:8080/hello
点击 Send
返回：Hello SpringBoot3 !

✅ 本章校验清单

1. Maven 依赖全部下载完毕，无报错
2. 项目正常启动，端口 8080
3. Postman 访问 /hello，成功拿到返回字符串

转载自 CSDN-专业IT技术社区

原文链接：https://blog.csdn.net/qq_36158551/article/details/165733661