前言

本案例基于 SpringBoot 2.7.x 版本（兼容 JDK 8/11），詳細(xì)演示兩種項(xiàng)目創(chuàng)建方式：無數(shù)據(jù)庫的基礎(chǔ)項(xiàng)目、集成 MySQL+MyBatis 的完整項(xiàng)目，包含環(huán)境配置、依賴選擇、運(yùn)行驗(yàn)證及常見問題解決，適合初學(xué)者快速上手。

一、環(huán)境準(zhǔn)備

1. 工具版本

• IDEA：推薦 2021 及以上版本（示例用 2023 版）
• JDK：JDK 11（或 JDK 8，需對應(yīng) SpringBoot 版本）
• Maven：3.6.x 及以上（IDEA 自帶可直接使用）

二、方式一：基礎(chǔ) SpringBoot 項(xiàng)目（無數(shù)據(jù)庫）

1. 項(xiàng)目創(chuàng)建步驟

（1）新建項(xiàng)目

打開 IDEA → 點(diǎn)擊「File」→「New」→「Project」→ 左側(cè)選擇「Spring Initializr」→ 確認(rèn)「Server URL」為默認(rèn)的https://start.spring.io → 點(diǎn)擊「Next」。

（2）項(xiàng)目信息配置

• Group：自定義包名（如com.example）
• Artifact：項(xiàng)目名（如springboot-demo）
• Type：選擇「Maven」
• Language：「Java」
• Version：默認(rèn)0.0.1-SNAPSHOT
• JDK：選擇已安裝的 JDK 11（或 8）
• Project Location：建議修改路徑至非 C 盤（如D:\projects\springboot-demo）

（3）依賴選擇

• 選擇 SpringBoot 版本：2.7.18（2.x 最新穩(wěn)定版）
• 勾選 3 個(gè)核心依賴：
  • Spring Web（提供 Web 開發(fā)支持，內(nèi)置 Tomcat）
  • Lombok（簡化實(shí)體類代碼，減少 get/set 方法）
  • Spring Boot DevTools（熱部署，修改代碼無需重啟項(xiàng)目）

點(diǎn)擊「Create」，等待 IDEA 下載依賴（首次創(chuàng)建需 5-10 分鐘，依賴下載完成后項(xiàng)目結(jié)構(gòu)無紅色報(bào)錯(cuò)即為成功）。

2. 運(yùn)行驗(yàn)證

• 找到自動(dòng)生成的主類（包路徑：src/main/java/com/example/springbootdemo/SpringbootDemoApplication.java）
• 右鍵主類 → 點(diǎn)擊「Run」運(yùn)行項(xiàng)目
• 控制臺(tái)出現(xiàn)以下日志即為啟動(dòng)成功：

  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 項(xiàng)目（推薦）

1. 項(xiàng)目創(chuàng)建步驟

（1）新建項(xiàng)目

同方式一第一步，選擇「Spring Initializr」→ 點(diǎn)擊「Next」。

（2）項(xiàng)目信息配置

與方式一一致，注意JDK 版本需與 SpringBoot 匹配（JDK 11 對應(yīng) 2.7.x，JDK 8 可兼容 2.7.x）。

（3）依賴選擇

• SpringBoot 版本：2.7.18
• 勾選依賴：
  • 基礎(chǔ)依賴：Spring Web + Lombok + DevTools（同上）
  • 數(shù)據(jù)庫依賴：
    • Spring Data JDBC（數(shù)據(jù)訪問基礎(chǔ)）
    • MySQL Driver（MySQL 數(shù)據(jù)庫驅(qū)動(dòng)）
    • MyBatis-Plus Boot Starter（簡化 MyBatis 操作，可選，也可手動(dòng)添加）

點(diǎn)擊「Create」，等待依賴下載完成。

2. 核心配置

（1）Maven 配置（可選）

若 IDEA 默認(rèn) 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」：設(shè)置本地倉庫路徑（如D:\maven\repo）
• 點(diǎn)擊「Apply」→「OK」，右鍵項(xiàng)目 →「Maven」→「Reload Project」刷新依賴。

（2）數(shù)據(jù)庫配置

在src/main/resources目錄下，將默認(rèn)的application.properties重命名為application.yml（YAML 格式更簡潔），添加以下配置：

yaml

server:
  port: 8080  # 項(xiàng)目啟動(dòng)端口（默認(rèn)8080，可改為80）
 
spring:
  datasource:
    type: com.alibaba.druid.pool.DruidDataSource  # 阿里德魯伊連接池（需手動(dòng)添加依賴）
    driver-class-name: com.mysql.cj.jdbc.Driver   # MySQL 8.x驅(qū)動(dòng)（兼容5.x）
    url: jdbc:mysql://localhost:3306/testdb?useUnicode=true&characterEncoding=utf8&serverTimezone=GMT%2B8
    username: root  # 數(shù)據(jù)庫用戶名
    password: 123456  # 數(shù)據(jù)庫密碼（替換為自己的密碼）
 
# MyBatis配置（若使用MyBatis-Plus則無需額外配置）
mybatis:
  mapper-locations: classpath:mapper/*.xml  # Mapper接口對應(yīng)的XML文件路徑
  type-aliases-package: com.example.springbootdemo.entity  # 實(shí)體類包路徑

（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. 運(yùn)行驗(yàn)證

• 確保本地 MySQL 已啟動(dòng)，且存在名為testdb的數(shù)據(jù)庫（可通過 Navicat 創(chuàng)建，編碼設(shè)為 utf8mb4）
• 運(yùn)行主類SpringbootDemoApplication，控制臺(tái)無報(bào)錯(cuò)且出現(xiàn)以下日志即為成功：

  plaintext

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

四、基礎(chǔ) Demo 編寫（驗(yàn)證接口訪問）

1. 創(chuàng)建 Controller 類

在主類同級目錄下新建controller包，創(chuàng)建HelloController.java：

java

package com.example.springbootdemo.controller;
 
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
 
@RestController  // 標(biāo)識為控制器，返回JSON格式數(shù)據(jù)
public class HelloController {
 
    @GetMapping("/hello")  // 定義GET請求接口，路徑為/hello
    public String hello() {
        return "SpringBoot項(xiàng)目創(chuàng)建成功！";
    }
}

2. 測試接口

啟動(dòng)項(xiàng)目后，打開瀏覽器訪問：http://localhost:8080/hello，頁面顯示SpringBoot項(xiàng)目創(chuàng)建成功！即為接口正常。

五、常見問題解決

1. 依賴報(bào)紅：右鍵項(xiàng)目 →「Maven」→「Reload Project」；或檢查pom.xml中依賴版本是否與 SpringBoot 匹配。
2. 啟動(dòng)報(bào)錯(cuò)：數(shù)據(jù)庫連接失敗：檢查application.yml中數(shù)據(jù)庫用戶名、密碼、庫名是否正確，MySQL 服務(wù)是否啟動(dòng)。
3. JDK 版本不兼容：SpringBoot 2.x 需 JDK 8/11，3.x 需 JDK 17，在「Project Structure」中重新指定 JDK 路徑。
4. 端口被占用：修改application.yml中server.port為其他端口（如 8081）。

通過以上步驟，即可完成 SpringBoot 項(xiàng)目的創(chuàng)建與基礎(chǔ)配置。

到此這篇關(guān)于Spring Boot項(xiàng)目創(chuàng)建兩種方式的文章就介紹到這了,更多相關(guān)Spring Boot項(xiàng)目創(chuàng)建內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評論