第10章 JPA 与 MySQL

第 10 节 / 共 17 节 课程:前后端穿透

后端真正难的不是写 Controller,而是把数据放对地方、查得出来、改得安全。这一章讲 JPA 怎么把 Java 对象映射到 MySQL 表,以及最常见的坑。

对象与表,靠注解对上Java 实体 CourseLong idString nameString introInteger sortNoInteger validMySQL 表 courseid BIGINT PKname VARCHAR(20)intro VARCHAR(1200)sort_no INTvalid CHAR(1)@Column 映射类名对应表名,字段对应列名;命名策略可以把 sortNo 自动转成 sort_no。不要让实体承担页面展示:需要额外字段时,用 DTO。
图 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;
 
    // getter / setter
}
注解作用注意
@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 本章练习

  1. 为 chapter 表建实体,字段包括 code、name、content、courseId、parentCode。
  2. 写一个按 courseId 查章节、按 code 排序的 Repository 方法。
  3. 用 EXPLAIN 对比加索引前后的查询计划。

下一章讲 Repository 之上的 Service:业务规则、事务、DTO 转换。