后端真正难的不是写 Controller,而是把数据放对地方、查得出来、改得安全。这一章讲 JPA 怎么把 Java 对象映射到 MySQL 表,以及最常见的坑。
图 10-1 实体字段与表结构的对应关系
10.1 先有表,再有实体
生产项目建议先写 SQL 建表,再写 Entity 对应。这样字段类型、索引、字符集都可控。下面是一张课程表:
CREATE TABLE course (
id INT PRIMARY KEY AUTO_INCREMENT,
name VARCHAR(20) NOT NULL,
intro VARCHAR(1200) DEFAULT NULL,
bref VARCHAR(20) DEFAULT NULL,
valid CHAR(1) DEFAULT '1',
sort_no INT DEFAULT 0,
datetime DATETIME DEFAULT CURRENT_TIMESTAMP
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
sort_no 控制课程顺序,valid 控制是否上架。这两个字段看起来简单,却决定了前台菜单和后台管理的很多逻辑。
10.2 实体映射
package cn.jssp.demo.entity;
import jakarta.persistence.*;
import java.time.LocalDateTime;
@Entity
@Table(name = "course")
public class Course {
@Id
@GeneratedValue(strategy = GenerationType.IDENTITY)
private Integer id;
@Column(nullable = false, length = 20)
private String name;
@Column(length = 1200)
private String intro;
@Column(length = 20)
private String bref;
@Column(length = 1)
private String valid;
@Column(name = "sort_no")
private Integer sortNo;
@Column(name = "datetime")
private LocalDateTime datetime;
}
| 注解 | 作用 | 注意 |
|---|
| @Entity | 声明这是一个实体 | 类名默认对应表名 |
| @Table(name="course") | 指定表名 | 表名和类名不一致时必写 |
| @Id | 主键 | 每个实体必须有 |
| @GeneratedValue | 主键生成策略 | MySQL 自增用 IDENTITY |
| @Column | 列名、长度、是否为空 | 不写也会按命名策略映射 |
10.3 Repository 不是 DAO 手写类
继承 JpaRepository,Spring 会自动实现增删改查。方法名有约定,例如 findByValidOrderBySortNoAsc 会被翻译成 SQL。
package cn.jssp.demo.repository;
import cn.jssp.demo.entity.Course;
import org.springframework.data.jpa.repository.JpaRepository;
import java.util.List;
public interface CourseRepository extends JpaRepository<Course, Integer> {
List<Course> findByValidOrderBySortNoAscIdAsc(String valid);
List<Course> findAllByOrderBySortNoAscIdAsc();
}
方法名解析规则:findBy + 条件 + OrderBy + 排序字段 + Asc/Desc。字段名必须和实体属性一致,不是数据库列名。
10.4 自定义查询
复杂查询用 @Query。优先用 JPQL(面向实体),需要数据库特性时再用 nativeQuery = true。
@Query("select c from Course c where c.valid = ?1 order by c.sortNo asc")
List<Course> findValid(String valid);
@Query(value = "select * from course where valid = ?1 order by sort_no asc", nativeQuery = true)
List<Course> findValidNative(String valid);
参数用 ?1 或 :valid 占位,不要用字符串拼接。拼接就是 SQL 注入的入口。
10.5 分页与排序
Page<Course> page = repository.findAll(
PageRequest.of(0, 10, Sort.by("sortNo").ascending())
);
long total = page.getTotalElements();
List<Course> list = page.getContent();
前端传 page、size,后端限制最大 size(例如 100),不要允许一次查十万条。
10.6 事务
一个业务动作涉及多张表时,要放在同一个事务里。否则第一步成功、第二步失败,数据就脏了。
@Service
public class CourseService {
@Transactional
public void publish(int courseId) {
Course c = repository.findById(courseId).orElseThrow();
c.setValid("1");
chapterRepository.updateVisible(courseId, true);
}
}
@Transactional 默认只对 RuntimeException 回滚。受检异常要显式写 rollbackFor = Exception.class。同类内部方法调用不会走代理,事务可能失效。
10.7 N+1 与懒加载
查 10 门课,每门课再查一次章节,就是 11 条 SQL。数据量一大就慢。常见解法:
- 用
@Query 一次 join fetch 出需要的数据;
- 先查主表,再用
in 批量查子表,在内存里组装;
- 只查列表需要的字段,用 DTO 投影。
@Query("select new cn.jssp.demo.dto.CourseBrief(c.id, c.name, count(ch.id)) " +
"from Course c left join Chapter ch on ch.courseId = c.id " +
"group by c.id, c.name")
List<CourseBrief> findBrief();
10.8 索引与慢查询
| 场景 | 建议索引 | 原因 |
|---|
| 按课程查章节 | chapter(course_id, code) | 最常用的列表查询 |
| 按课程+上架过滤 | course(valid, sort_no) | 菜单排序 |
| 按学员+题目查批改 | chapter_quiz_correct(student_id, quiz_id) | 统计与错题 |
| 模糊搜索 | 全文索引或搜索引擎 | 前置 % 的 like 用不上普通索引 |
用 EXPLAIN 看执行计划。type 是 ALL 表示全表扫描;key 为 NULL 表示没走索引。不要凭感觉加索引,索引会拖慢写入。
10.9 常见错误
| 现象 | 原因 | 处理 |
|---|
| 表找不到 | 实体名/表名不一致 | @Table 指定表名 |
| 字段找不到 | 驼峰与下划线 | spring.jpa.hibernate.naming 或 @Column |
| 日期差 8 小时 | 时区不对 | serverTimezone=Asia/Shanghai |
| 中文乱码 | 字符集不是 utf8mb4 | 库、表、连接三处统一 |
| 删除报外键错 | 有子表引用 | 先删子表或改级联策略 |
10.10 本章练习
- 为 chapter 表建实体,字段包括 code、name、content、courseId、parentCode。
- 写一个按 courseId 查章节、按 code 排序的 Repository 方法。
- 用
EXPLAIN 对比加索引前后的查询计划。
下一章讲 Repository 之上的 Service:业务规则、事务、DTO 转换。