Spring Boot项目创建两种方式的全流程

前言

本案例基于 SpringBoot 2.7.x 版本（兼容 JDK 8/11），详细演示两种项目创建方式：无数据库的基础项目、集成 MySQL+MyBatis 的完整项目，包含环境配置、依赖选择、运行验证及常见问题解决，适合初学者快速上手。

一、环境准备

1. 工具版本

• IDEA：推荐 2021 及以上版本（示例用 2023 版）
• JDK：JDK 11（或 JDK 8，需对应 SpringBoot 版本）
• Maven：3.6.x 及以上（IDEA 自带可直接使用）

二、方式一：基础 SpringBoot 项目（无数据库）

1. 项目创建步骤

（1）新建项目

打开 IDEA → 点击「File」→「New」→「Project」→ 左侧选择「Spring Initializr」→ 确认「Server URL」为默认的https://start.spring.io → 点击「Next」。

（2）项目信息配置

• Group：自定义包名（如com.example）
• Artifact：项目名（如springboot-demo）
• Type：选择「Maven」
• Language：「Java」
• Version：默认0.0.1-SNAPSHOT
• JDK：选择已安装的 JDK 11（或 8）
• Project Location：建议修改路径至非 C 盘（如D:\projects\springboot-demo）

（3）依赖选择

• 选择 SpringBoot 版本：2.7.18（2.x 最新稳定版）
• 勾选 3 个核心依赖：
  • Spring Web（提供 Web 开发支持，内置 Tomcat）
  • Lombok（简化实体类代码，减少 get/set 方法）
  • Spring Boot DevTools（热部署，修改代码无需重启项目）

点击「Create」，等待 IDEA 下载依赖（首次创建需 5-10 分钟，依赖下载完成后项目结构无红色报错即为成功）。

2. 运行验证

• 找到自动生成的主类（包路径：src/main/java/com/example/springbootdemo/SpringbootDemoApplication.java）
• 右键主类 → 点击「Run」运行项目
• 控制台出现以下日志即为启动成功：

  plaintext

Tomcat started on port(s): 8080 (http) with context path ''
Started SpringbootDemoApplication in 2.345 seconds (JVM running for 3.123)

三、方式二：集成 MySQL+MyBatis 的 SpringBoot 项目（推荐）

1. 项目创建步骤

（1）新建项目

同方式一第一步，选择「Spring Initializr」→ 点击「Next」。

（2）项目信息配置

与方式一一致，注意JDK 版本需与 SpringBoot 匹配（JDK 11 对应 2.7.x，JDK 8 可兼容 2.7.x）。

（3）依赖选择

• SpringBoot 版本：2.7.18
• 勾选依赖：
  • 基础依赖：Spring Web + Lombok + DevTools（同上）
  • 数据库依赖：
    • Spring Data JDBC（数据访问基础）
    • MySQL Driver（MySQL 数据库驱动）
    • MyBatis-Plus Boot Starter（简化 MyBatis 操作，可选，也可手动添加）

点击「Create」，等待依赖下载完成。

2. 核心配置

（1）Maven 配置（可选）

若 IDEA 默认 Maven 仓库在 C 盘，可修改为自定义路径：

• 打开「File」→「Settings」→ 搜索「Maven」
• 「Maven home path」：选择本地 Maven 路径（如D:\maven\apache-maven-3.6.3）
• 「User settings file」：勾选「Override」，选择maven/conf/settings.xml
• 「Local repository」：设置本地仓库路径（如D:\maven\repo）
• 点击「Apply」→「OK」，右键项目 →「Maven」→「Reload Project」刷新依赖。

（2）数据库配置

在src/main/resources目录下，将默认的application.properties重命名为application.yml（YAML 格式更简洁），添加以下配置：

yaml

server:
  port: 8080  # 项目启动端口（默认8080，可改为80）
 
spring:
  datasource:
    type: com.alibaba.druid.pool.DruidDataSource  # 阿里德鲁伊连接池（需手动添加依赖）
    driver-class-name: com.mysql.cj.jdbc.Driver   # MySQL 8.x驱动（兼容5.x）
    url: jdbc:mysql://localhost:3306/testdb?useUnicode=true&characterEncoding=utf8&serverTimezone=GMT%2B8
    username: root  # 数据库用户名
    password: 123456  # 数据库密码（替换为自己的密码）
 
# MyBatis配置（若使用MyBatis-Plus则无需额外配置）
mybatis:
  mapper-locations: classpath:mapper/*.xml  # Mapper接口对应的XML文件路径
  type-aliases-package: com.example.springbootdemo.entity  # 实体类包路径

（3）添加德鲁伊连接池依赖

打开pom.xml，在<dependencies>中添加：

xml

<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>druid-spring-boot-starter</artifactId>
    <version>1.2.16</version>  # 与SpringBoot 2.7.x兼容
</dependency>

3. 运行验证

• 确保本地 MySQL 已启动，且存在名为testdb的数据库（可通过 Navicat 创建，编码设为 utf8mb4）
• 运行主类SpringbootDemoApplication，控制台无报错且出现以下日志即为成功：

  plaintext

DruidDataSource initialized
Tomcat started on port(s): 8080 (http) with context path ''

四、基础 Demo 编写（验证接口访问）

1. 创建 Controller 类

在主类同级目录下新建controller包，创建HelloController.java：

java

package com.example.springbootdemo.controller;
 
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
 
@RestController  // 标识为控制器，返回JSON格式数据
public class HelloController {
 
    @GetMapping("/hello")  // 定义GET请求接口，路径为/hello
    public String hello() {
        return "SpringBoot项目创建成功！";
    }
}

2. 测试接口

启动项目后，打开浏览器访问：http://localhost:8080/hello，页面显示SpringBoot项目创建成功！即为接口正常。

五、常见问题解决

1. 依赖报红：右键项目 →「Maven」→「Reload Project」；或检查pom.xml中依赖版本是否与 SpringBoot 匹配。
2. 启动报错：数据库连接失败：检查application.yml中数据库用户名、密码、库名是否正确，MySQL 服务是否启动。
3. JDK 版本不兼容：SpringBoot 2.x 需 JDK 8/11，3.x 需 JDK 17，在「Project Structure」中重新指定 JDK 路径。
4. 端口被占用：修改application.yml中server.port为其他端口（如 8081）。

通过以上步骤，即可完成 SpringBoot 项目的创建与基础配置。

到此这篇关于Spring Boot项目创建两种方式的文章就介绍到这了,更多相关Spring Boot项目创建内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

最新评论