IDEA中為SpringBoot項目接入MySQL數(shù)據(jù)庫的詳細指南
前言
MySQL作為最流行的開源關(guān)系型數(shù)據(jù)庫，與Spring Boot的整合是企業(yè)級開發(fā)的標配。本文將手把手教你在IntelliJ IDEA中為Spring Boot項目接入MySQL數(shù)據(jù)庫，涵蓋依賴配置、實體類映射、JPA操作及常見避坑指南，助你快速實現(xiàn)數(shù)據(jù)持久化！
一、環(huán)境準備
1. 基礎(chǔ)環(huán)境
已安裝IntelliJ IDEA并創(chuàng)建Spring Boot項目（參考文章）。
本地安裝MySQL 5.7+（推薦8.0），并創(chuàng)建數(shù)據(jù)庫（如springboot_db）。
2. 檢查依賴
確保項目包含Spring Web、Spring Data JPA和MySQL Driver依賴（可通過pom.xml添加）。
二、添加MySQL依賴
修改pom.xml
在<dependencies>中添加以下依賴：
<!-- Spring Data JPA -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-data-jpa</artifactId>
</dependency>
<!-- MySQL驅(qū)動（版本需與本地MySQL一致） -->
<dependency>
<groupId>com.mysql</groupId>
<artifactId>mysql-connector-j</artifactId>
<scope>runtime</scope>
</dependency>
<!-- 可選：Lombok簡化代碼 -->
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<optional>true</optional>
</dependency>
注意：Spring Boot 3.x默認使用MySQL 8.x驅(qū)動，若使用MySQL 5.x需指定驅(qū)動版本（如5.1.49）。
三、配置MySQL連接
1. 修改application.properties
在src/main/resources/application.properties中添加數(shù)據(jù)庫配置：
# 數(shù)據(jù)源配置 spring.datasource.url=jdbc:mysql://localhost:3306/springboot_db?useSSL=false&serverTimezone=UTC spring.datasource.username=root spring.datasource.password=123456 spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver # JPA配置 spring.jpa.hibernate.ddl-auto=update spring.jpa.show-sql=true spring.jpa.properties.hibernate.format_sql=true
關(guān)鍵參數(shù)解釋：
- spring.jpa.hibernate.ddl-auto=update：啟動時自動更新表結(jié)構(gòu)（可選create、none）。
- useSSL=false：禁用SSL（本地開發(fā)可關(guān)閉）。
- serverTimezone=UTC：統(tǒng)一時區(qū)，避免時間差問題。
2. 驗證配置
啟動項目，若控制臺輸出以下日志，說明數(shù)據(jù)庫連接成功：
HikariPool-1 - Start completed
四、創(chuàng)建實體類與Repository
1. 定義實體類（User）
package com.example.demo.entity;
import jakarta.persistence.*;
import lombok.Data;
@Data
@Entity
@Table(name = "user") // 指定表名
public class User {
@Id
@GeneratedValue(strategy = GenerationType.IDENTITY)
private Long id;
@Column(nullable = false, unique = true)
private String username;
@Column(nullable = false)
private String password;
private String email;
}
注解說明：
- @Entity：標記為JPA實體。
- @Table：指定映射的表名。
- @Data：Lombok注解，自動生成getter/setter。
2. 創(chuàng)建Repository接口
package com.example.demo.repository;
import com.example.demo.entity.User;
import org.springframework.data.jpa.repository.JpaRepository;
public interface UserRepository extends JpaRepository<User, Long> {
// 自定義查詢方法（按用戶名查找）
User findByUsername(String username);
}
五、編寫Service與Controller
1. 實現(xiàn)Service層
package com.example.demo.service;
import com.example.demo.entity.User;
import com.example.demo.repository.UserRepository;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
@Service
public class UserService {
@Autowired
private UserRepository userRepository;
public User saveUser(User user) {
return userRepository.save(user);
}
public User findUserByUsername(String username) {
return userRepository.findByUsername(username);
}
}
2. 編寫RESTful Controller
package com.example.demo.controller;
import com.example.demo.entity.User;
import com.example.demo.service.UserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;
@RestController
@RequestMapping("/api/users")
public class UserController {
@Autowired
private UserService userService;
@PostMapping
public User createUser(@RequestBody User user) {
return userService.saveUser(user);
}
@GetMapping("/{username}")
public User getUser(@PathVariable String username) {
return userService.findUserByUsername(username);
}
}
六、測試與驗證
1. 啟動應(yīng)用
運行啟動類DemoApplication，觀察控制臺是否生成建表SQL：
create table user (
id bigint not null auto_increment,
email varchar(255),
password varchar(255) not null,
username varchar(255) not null unique,
primary key (id)
);
2. 使用Postman測試API
新增用戶（POST請求）：URL：http://localhost:8080/api/users
Body（JSON）：
{
"username": "csdn_user",
"password": "123456",
"email": "csdn@example.com"
}
查詢用戶（GET請求）：URL：http://localhost:8080/api/users/csdn_user
七、常見問題與解決方案
Q1：數(shù)據(jù)庫連接失敗（Access denied）
原因：用戶名/密碼錯誤，或用戶無權(quán)限訪問數(shù)據(jù)庫。
解決：
檢查application.properties中的username和password。
在MySQL中授權(quán)用戶：
GRANT ALL PRIVILEGES ON springboot_db.* TO 'root'@'localhost'; FLUSH PRIVILEGES;
Q2：驅(qū)動類未找到（Driver class not found）
原因：MySQL驅(qū)動版本與配置不匹配。
解決：
檢查spring.datasource.driver-class-name是否為com.mysql.cj.jdbc.Driver（MySQL 8.x）。
確認pom.xml中MySQL依賴未沖突。
Q3：時區(qū)錯誤（ServerTimezone not configured）
解決：在JDBC URL中添加&serverTimezone=Asia/Shanghai（或UTC）。
Q4：表不存在（Table ‘springboot_db.user’ doesn’t exist）
解決：
確保spring.jpa.hibernate.ddl-auto=update。
檢查實體類@Table(name="user")是否與數(shù)據(jù)庫表名一致。
總結(jié)
通過Spring Data JPA，開發(fā)者無需編寫SQL即可實現(xiàn)MySQL數(shù)據(jù)庫的CRUD操作。本文從配置到實戰(zhàn)演示了完整的接入流程，并針對常見錯誤提供解決方案。
到此這篇關(guān)于IDEA中為SpringBoot項目接入MySQL數(shù)據(jù)庫的詳細指南的文章就介紹到這了,更多相關(guān)IDEA SpringBoot接入MySQL數(shù)據(jù)庫內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！
- IDEA中SpringBoot項目數(shù)據(jù)庫連接加密方法
- idea中springboot項目連接數(shù)據(jù)庫報錯的原因解析
- springboot+idea+maven 多模塊項目搭建的詳細過程（連接數(shù)據(jù)庫進行測試）
- IntelliJ Idea SpringBoot 數(shù)據(jù)庫增刪改查實例詳解
- IDEA創(chuàng)建SpringBoot項目整合mybatis時mysql-connector-java報錯異常的詳細分析
- IDEA下創(chuàng)建SpringBoot+MyBatis+MySql項目實現(xiàn)動態(tài)登錄與注冊功能
相關(guān)文章
Java?Lombok實現(xiàn)手機號碼校驗的示例代碼
手機號碼校驗通常是系統(tǒng)開發(fā)中最基礎(chǔ)的功能之一，本文主要介紹了Java?Lombok實現(xiàn)手機號碼校驗的示例代碼，文中通過示例代碼介紹的非常詳細，對大家的學(xué)習或者工作具有一定的參考學(xué)習價值，需要的朋友們下面隨著小編來一起學(xué)習學(xué)習吧2023-07-07
由于要將“哈密頓回路問題(TSP)”的求解中間結(jié)果表示出來，查了一下使用程序畫多邊形圖形?，F(xiàn)在在總結(jié)一下，這個圖是“由給定節(jié)點首尾相連的”閉合多邊形2014-02-02
關(guān)于socket發(fā)送數(shù)據(jù)需要注意的問題
這篇文章主要介紹了關(guān)于socket發(fā)送數(shù)據(jù)需要注意的問題,具有很好的參考價值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教2024-08-08
下面小編就為大家?guī)硪黄P(guān)于Spring總結(jié)(必看篇)。小編覺得挺不錯的，現(xiàn)在就分享給大家，也給大家做個參考。一起跟隨小編過來看看吧2017-08-08
這篇文章主要介紹了Java中RSA加密解密的實現(xiàn)方法,結(jié)合具體實例形式分析了java實現(xiàn)RSA加密解密算法的具體步驟與相關(guān)操作技巧,并附帶了關(guān)于RSA算法密鑰長度/密文長度/明文長度的參考說明,需要的朋友可以參考下2017-07-07
這篇文章主要介紹了Java IO流常用字節(jié)字符流原理解析,文中通過示例代碼介紹的非常詳細，對大家的學(xué)習或者工作具有一定的參考學(xué)習價值,需要的朋友可以參考下2020-03-03
這篇文章主要介紹了Java實現(xiàn)pdf轉(zhuǎn)圖片案例,按照步驟放置代碼,一步步完成該案例,將代碼部署便可,需要的朋友可以參考下2021-06-06
SpringCloud中Sentinel基礎(chǔ)場景和異常處理方式
這篇文章主要介紹了SpringCloud中Sentinel基礎(chǔ)場景和異常處理方式,具有很好的參考價值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教2025-04-04
Java多線程實現(xiàn)方式有兩種，第一種是繼承Thread類，第二種是實現(xiàn)Runnable接口，兩種有很多差異，下面跟著本文一起學(xué)習吧2015-11-11
這篇文章主要介紹了java?web項目Session獲取不到問題及解決方案，具有很好的參考價值，希望對大家有所幫助。如有錯誤或未考慮完全的地方，望不吝賜教2022-01-01