Spring Boot 集成 JPA 全攻略

一、前言

在 Java Web 開發中，數據庫訪問是繞不開的話題。
傳統方式使用 JDBC 編寫 SQL，維護困難、可讀性差。后來有了 MyBatis 這種半自動 ORM 框架，再到 JPA（Java Persistence API）這種全自動 ORM 規范，可以讓我們用面向對象的方式操作數據庫，而不必寫大量 SQL。

Spring Boot 對 JPA 提供了非常友好的自動化支持，幾乎可以“零配置”就完成數據庫操作。

---

二、JPA 簡介

JPA（Java Persistence API）并不是一個具體實現，而是 Java 官方定義的 ORM 規范，它的常見實現有：

• Hibernate（最常用，Spring Boot 默認 JPA 實現）
• EclipseLink
• OpenJPA

核心思想：
用 實體類（Entity）映射數據庫表，用 方法調用 代替手寫 SQL。
例如：

// 查詢所有用戶
List<User> users = userRepository.findAll();// 根據用戶名查詢
User user = userRepository.findByUsername("Tom");

---

三、項目環境準備

1. 新建 Spring Boot 項目

在 Spring Initializr 選擇：

• Spring Boot 版本：3.x（或 2.7.x）

• 依賴：

  • Spring Web
  • Spring Data JPA
  • MySQL Driver

生成后導入 IDE（IntelliJ IDEA / VSCode）。

---

2. Maven 依賴

如果是手動添加，pom.xml 配置如下：

<dependencies><!-- Spring Web --><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency><!-- Spring Data JPA --><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-data-jpa</artifactId></dependency><!-- MySQL 驅動 --><dependency><groupId>com.mysql</groupId><artifactId>mysql-connector-j</artifactId><scope>runtime</scope></dependency><!-- 測試依賴 --><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-test</artifactId><scope>test</scope></dependency>
</dependencies>

---

3. 配置數據庫連接

在 application.yml 中配置：

spring:datasource:url: jdbc:mysql://localhost:3306/jpa_demo?useSSL=false&serverTimezone=UTCusername: rootpassword: 123456driver-class-name: com.mysql.cj.jdbc.Driverjpa:hibernate:ddl-auto: update   # 自動建表（create、update、validate、none）show-sql: true       # 控制臺打印 SQLproperties:hibernate:format_sql: true # 格式化 SQL 輸出

ddl-auto 參數說明：

• create：每次啟動刪除舊表，創建新表
• update：如果表不存在則創建，如果有新字段則更新
• validate：驗證表結構和實體類是否匹配
• none：不做任何處理

---

四、編寫 JPA 樣例

1. 創建實體類

User.java

package com.example.jpademo.entity;import jakarta.persistence.*;
import lombok.Data;@Data
@Entity
@Table(name = "users") // 表名
public class User {@Id@GeneratedValue(strategy = GenerationType.IDENTITY) // 自增主鍵private Long id;@Column(nullable = false, unique = true, length = 50)private String username;@Column(nullable = false)private String password;
}

---

2. 創建 Repository 接口

UserRepository.java

package com.example.jpademo.repository;import com.example.jpademo.entity.User;
import org.springframework.data.jpa.repository.JpaRepository;public interface UserRepository extends JpaRepository<User, Long> {// 按用戶名查找User findByUsername(String username);
}

JpaRepository 已經內置了大量方法：save()、findAll()、findById()、deleteById() 等。

---

3. 創建 Service 層

UserService.java

package com.example.jpademo.service;import com.example.jpademo.entity.User;
import com.example.jpademo.repository.UserRepository;
import org.springframework.stereotype.Service;import java.util.List;@Service
public class UserService {private final UserRepository userRepository;public UserService(UserRepository userRepository) {this.userRepository = userRepository;}public List<User> getAllUsers() {return userRepository.findAll();}public User createUser(User user) {return userRepository.save(user);}
}

---

4. 創建 Controller

UserController.java

package com.example.jpademo.controller;import com.example.jpademo.entity.User;
import com.example.jpademo.service.UserService;
import org.springframework.web.bind.annotation.*;import java.util.List;@RestController
@RequestMapping("/users")
public class UserController {private final UserService userService;public UserController(UserService userService) {this.userService = userService;}@GetMappingpublic List<User> list() {return userService.getAllUsers();}@PostMappingpublic User add(@RequestBody User user) {return userService.createUser(user);}
}

---

五、運行測試

1. 啟動 Spring Boot 項目（IDEA Run）

2. 使用 Postman 測試：

   • 新增用戶

     POST http://localhost:8080/users
     Content-Type: application/json{"username": "Tom","password": "123456"
     }
     

   • 查詢所有用戶

     GET http://localhost:8080/users
     

控制臺會輸出類似：

insert into users (password, username) values (?, ?)
select u1_0.id, u1_0.password, u1_0.username from users u1_0

---

六、常見問題

1. 為什么啟動時會自動建表？
   因為 spring.jpa.hibernate.ddl-auto 設置了 update，Hibernate 會自動根據實體生成表結構。

2. 不想自動建表怎么辦？
   把 ddl-auto 改成 none 或 validate，用手動 SQL 建表。

3. 怎么寫復雜 SQL？

   • 方法名查詢：findByUsernameAndPassword
   • JPQL 查詢：@Query("select u from User u where u.username = ?1")
   • 原生 SQL：@Query(value = "select * from users where username = ?1", nativeQuery = true)

---

七、總結

Spring Boot 集成 JPA 最大的優點就是：

• 幾乎零配置即可運行
• 面向對象操作數據庫，減少 SQL 編寫
• 內置方法豐富，支持分頁、排序、條件查詢
• 復雜 SQL 也可以靈活編寫

但要注意：

• 適合中小型業務，超復雜 SQL 可能 MyBatis 更高效
• ddl-auto 在生產環境建議設為 none，防止誤刪表
• 盡量用事務（@Transactional）保證數據一致性

---