简介一套面向 Spring Boot 初学者的极简入门项目演示在 Spring Boot 工程中整合 Hibernate 并连接 MySQL 数据库完成数据插入和查询操作适合正在学习自动配置、实体映射以及基础数据访问方式的开发者。压缩包共 155 个文件其中 64 个为依赖 jar 包其余主要包括 Java 源码、编译后的 class 文件、配置文件、页面文件以及数据库建表脚本整体大小 34.25MB。项目已将运行所需的依赖和数据库脚本准备齐全拿到后只需创建数据库并执行 SQL 建立数据表即可在本地启动并走通插入和查询流程省去手动下载依赖和反复调整环境的步骤。目前已有 1826 人学习下载可当作 Spring Boot 结合 Hibernate 的第一个练手项目。通过这份样例能够直观了解依赖目录组织、数据库连接配置、建表脚本与基础数据操作之间的对应关系也方便在此基础上修改扩展迁移到自己的业务代码中。1. 这个例子到底解决什么问题Spring Boot 里再直接使用 Hibernate 的最短路径初学或者维护老项目时很多人以为 Spring Boot 项目里用 Hibernate 就是引入 spring-boot-starter-data-jpa 然后写 Repository 接口。但当你接到一个不使用 JPA 注解、只依赖 Hibernate 原生 SessionFactory 的存量系统或者想绕开 JPA 的自动 save 逻辑、完全掌握 SQL 与事务边界时就会发现 Spring Boot 官方文档并没有给你一个「不写 Repository 也能跑通」的最小例子。本文全是经验之谈可以用作落地参考。这个标题的核心是把 Spring Boot 作为容器、Hibernate 作为持久层、MySQL 作为存储三者在一个真实可启动的工程里协作起来。适合这几种读者刚学完 Spring Boot 基础想补 Hibernate 原生 API 的人接手了老项目被迫迁移到 Spring Boot 的人以及想摆脱 Spring Data 封装、想用 Session 的 get/load/createQuery 来掌控数据访问的人。从最小例子出发你会看到三个完整可复制的文件pom.xml、application.properties、一个封装了 Hibernate 工具类外加一个 Service 与 Controller 组成的最小闭环。整套代码跑通后你能看到插入、查询、事务回滚的真实效果也能知道为什么网上很多例子会启动失败——大部分翻车点不在代码逻辑而在 Spring Boot 版本与 Hibernate 版本的交错上。这是我踩过最多的坑会在后面的排查章节里给到具体的处理方案。2. 搭建最小工程Maven 依赖与目录拆解、配置文件逐个说清2.1 选型思路为什么不用 Spring Data JPA 而直接引入 HibernateSpring Boot 官方比较推荐的是 spring-boot-starter-data-jpa它会自动拉取 Hibernate 并帮你封装 Repository。但标题既然特意写「springboothibernatemysql」这类场景通常是存量代码已经使用 Hibernate 的 SessionFactory、hbm.xml 映射或者团队习惯了直接操作 Session。此时强行改成 JPA 的 Repository 风格意味着大量重写而直接在 Spring Boot 里注册 Hibernate 的 SessionFactory 则不然小项目只需要一个 Configuration 类就能把一个旧 Hibernate 工程安稳地嵌入。从技术分工看Spring Boot 负责对象创建与依赖注入Hibernate 负责会话与缓存MySQL 负责持久化。如果你没有把 SessionFactory 纳入 Spring 容器管理你会在每个需要持久化的地方手动 new Configuration().buildSessionFactory()这会造成 SessionFactory 重复创建大一点的项目会直接导致连接池被打满。正确做法是让 Spring Boot 管理 SessionFactory所有代码通过注入使用同一个工厂同时让 Spring 的声明式事务统一管理事务边界。常见做法是加入以下三个依赖spring-boot-starter-web 提供 Web 能力mysql-connector-java 提供驱动以及 hibernate-core 提供核心 API。不要同时引入 spring-boot-starter-data-jpa因为 JPA 启动器也会自动装配一个 EntityManagerFactory这和我们要手动注册的 SessionFactory 会在部分场景下冲突。如果你确实需要 JPA 注解的一些能力后面章节会给出抽离方案。2.2 pom.xml 最小写法三个依赖加一个插件别让版本玄学耽误你先贴一份我在模拟项目 X 里验证过的完整 pom.xml。注意刻意避开了 Spring Data JPA 相关的 starter版本号选择了一个稳定组合Spring Boot 2.7.x 搭配 Hibernate 5.6.x没有使用 Hibernate 6原因是 Hibernate 6 的包名与 API 变化较大存量代码迁移成本高。?xml version1.0 encodingUTF-8? project xmlnshttp://maven.apache.org/POM/4.0.0 xmlns:xsihttp://www.w3.org/2001/XMLSchema-instance xsi:schemaLocationhttp://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd modelVersion4.0.0/modelVersion parent groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-parent/artifactId version2.7.18/version relativePath/ /parent groupIdcom.example/groupId artifactIdspringboot-hibernate-mysql-demo/artifactId version1.0.0/version namespringboot-hibernate-mysql-demo/name descriptionSpring Boot Hibernate MySQL 最小可运行例子/description properties java.version8/java.version !-- 显式指定 Hibernate 版本避免 Spring Boot 默认拉取不兼容的依赖 -- hibernate.version5.6.15.Final/hibernate.version /properties dependencies !-- Web 依赖提供 Spring MVC 能力 -- dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency !-- MySQL 驱动Spring Boot 2.7 对应的是 8.0.x 版本 -- dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId scoperuntime/scope /dependency !-- Hibernate 核心不引入 JPA 启动器 -- dependency groupIdorg.hibernate/groupId artifactIdhibernate-core/artifactId version${hibernate.version}/version /dependency !-- 方便后续实体类调试非必须 -- dependency groupIdorg.projectlombok/groupId artifactIdlombok/artifactId optionaltrue/optional /dependency /dependencies build plugins plugin groupIdorg.springframework.boot/groupId artifactIdspring-boot-maven-plugin/artifactId /plugin /plugins /build /project逻辑说明parent 继承了 Spring Boot 的依赖管理mysql-connector-java 的版本由 Spring Boot 统一控制不需要写死而 hibernate-core 是我单独覆盖了版本这步很关键因为 Spring Boot 2.7.x 的默认依赖管理里也有一份 Hibernate 版本如果不显式指定会让人困惑到底哪个版本生效。参数说明java.version 设置为 8 是为了兼容老项目环境如果你的项目跑在 JDK 11 甚至 17 上可以改成 11 或 17但 Hibernate 5.6 对 JDK 17 的支持没问题Spring Boot 2.7 也对 JDK 17 支持良好。hibernate.version 标签覆盖的优先级高于 parent 里的 dependencyManagement这是我反复确认过的机制写在这里可以直接抄。2.3 application.properties 与 Hibernate 配置类数据库连接、方言、自动建表接下来是配置文件。Spring Boot 的 application.properties 里需要定义数据源信息。同时要用一个配置类把 Hibernate 的 SessionFactory 注册为 Spring Bean这样 Controller 或 Service 里就能直接用 Autowired 注入。# 数据源基本配置 spring.datasource.urljdbc:mysql://localhost:3306/demo?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneAsia/Shanghai spring.datasource.usernameroot spring.datasource.passwordroot123456 spring.datasource.driver-class-namecom.mysql.cj.jdbc.Driver # Hibernate 相关配置 spring.jpa.database-platformorg.hibernate.dialect.MySQL8Dialect spring.jpa.show-sqltrue spring.jpa.properties.hibernate.format_sqltrue spring.jpa.properties.hibernate.hbm2ddl.autoupdate这里的 spring.jpa.* 前缀其实是 Spring Boot 的 JPA 自动配置读取的但即使我们没有引入 spring-boot-starter-data-jpa只要存在 Hibernate 核心依赖Spring Boot 的 HibernateJpaAutoConfiguration 仍会尝试自动装配。我这里的做法是额外注册一个 SessionFactory Bean但把自动装配的依赖阻断掉避免冲突。也见过有同事让 hbm2ddl.auto 保持 create-drop用完即删表这种在调试阶段可以但如果你是想正常落地使用建议用 update。再写 Hibernate 配置类package com.example.config; import org.hibernate.SessionFactory; import org.springframework.beans.factory.annotation.Value; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; import org.springframework.jdbc.datasource.DriverManagerDataSource; import org.springframework.orm.hibernate5.LocalSessionFactoryBean; import org.springframework.transaction.annotation.EnableTransactionManagement; import javax.sql.DataSource; import java.util.Properties; Configuration EnableTransactionManagement public class HibernateConfig { Value(${spring.datasource.driver-class-name}) private String driverClassName; Value(${spring.datasource.url}) private String url; Value(${spring.datasource.username}) private String username; Value(${spring.datasource.password}) private String password; Bean public DataSource dataSource() { DriverManagerDataSource dataSource new DriverManagerDataSource(); dataSource.setDriverClassName(driverClassName); dataSource.setUrl(url); dataSource.setUsername(username); dataSource.setPassword(password); return dataSource; } Bean public LocalSessionFactoryBean sessionFactory(DataSource dataSource) { LocalSessionFactoryBean sessionFactory new LocalSessionFactoryBean(); sessionFactory.setDataSource(dataSource); // 实体类所在的包Hibernate 启动时会扫描这个包下的 Entity sessionFactory.setPackagesToScan(com.example.entity); sessionFactory.setHibernateProperties(hibernateProperties()); return sessionFactory; } private Properties hibernateProperties() { Properties properties new Properties(); properties.put(hibernate.dialect, org.hibernate.dialect.MySQL8Dialect); // 自动建表: update 表示有表则更新无表则创建 properties.put(hibernate.hbm2xml.auto, update); // 控制台输出 SQL方便调试生产环境记得关闭 properties.put(hibernate.show_sql, true); properties.put(hibernate.format_sql, true); return properties; } }逻辑说明LocalSessionFactoryBean 是 Spring 提供的适配器最终返回的 Bean 类型是 SessionFactory。DataSource 单独注册出来是为了之后如果需要集成连接池或者多数据源可以在不修改实体层的情况下切换。参数说明packagesToScan 指向实体类包Hibernate 用它做注解扫描漏写会导致启动时报 SessionFactory 没有映射实体类 的错hibernate.dialect 选择 MySQL8Dialect 是因为我们用的 MySQL 8.x如果 MySQL 5.7 需要降级为 MySQL5InnoDBDialect否则分页语法会出现 COALESCE 这类函数兼容问题这个细节值得留意。3. 实体与 DAO注解映射的字段约定、原生 Session 查询的正确姿势3.1 实体类Entity 与 Table 的关系、字段到列的映射规则写实体类时最容易出现的一种疑问是既然用了 Hibernate 的原生 API 而不是 JPA Repository实体上的注解还要不要写 JPA 的 Entity。答案是需要因为 Hibernate 本身实现了 JPA 规范Entity、Table、Column 这些注解是实体元数据的载体就算你用 Session 的 save 方法同样需要读取这些注解来生成 SQL。下面给一个贴合真实业务的最小实体学生信息表。package com.example.entity; import javax.persistence.*; import java.time.LocalDateTime; Entity Table(name student) public class Student { Id GeneratedValue(strategy GenerationType.IDENTITY) private Long id; Column(name student_name, nullable false, length 64) private String studentName; Column(name student_no, unique true, nullable false, length 32) private String studentNo; Column(name status, nullable false) private Integer status; Column(name create_time, nullable false, updatable false) private LocalDateTime createTime; // 构造函数、Getter/Setter 在此省略用 IDE 生成即可 public Student() { } public Student(String studentName, String studentNo, Integer status, LocalDateTime createTime) { this.studentName studentName; this.studentNo studentNo; this.status status; this.createTime createTime; } public Long getId() { return id; } public void setId(Long id) { this.id id; } public String getStudentName() { return studentName; } public void setStudentName(String studentName) { this.studentName studentName; } public String getStudentNo() { return studentNo; } public void setStudentNo(String studentNo) { this.studentNo studentNo; } public Integer getStatus() { return status; } public void setStatus(Integer status) { this.status status; } public LocalDateTime getCreateTime() { return createTime; } public void setCreateTime(LocalDateTime createTime) { this.createTime createTime; } }关于字段映射值得说明的几点字段名采用驼峰Column 显式指定数据库列名避免依赖 Hibernate 的物理命名策略如果你不写 ColumnHibernate 5 默认会把 studentName 映射成 student_name这个隐含规则在存量数据库字段命名不一致时是个坑。strategy GenerationType.IDENTITY 对应 MySQL 的自增主键如果换成 GenerationType.AUTOHibernate 会创建 hibernate_sequence 表这不是我们想要的需要注意。3.2 DAO 层从 SessionFactory 获取 Sessiontry-with-resources 的隐患DAO 层是直接与 Session 打交道的部分。推荐的方式是使用 SessionFactory 的 openSession 方法打开一个临时 Session执行完整操作后关闭。不要使用 getCurrentSession它在 Spring 集成场景里会跟事务绑死初学者很容易因为没开启事务而得到 No CurrentSessionContext configured 的报错。下面是 DAO 的标准写法package com.example.dao; import com.example.entity.Student; import org.hibernate.Session; import org.hibernate.SessionFactory; import org.hibernate.query.Query; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.stereotype.Repository; import java.util.List; Repository public class StudentDao { Autowired private SessionFactory sessionFactory; /** * 插入学生 * 使用 openSession 获取独立 Session操作完在 finally 中关闭 */ public void save(Student student) { Session session sessionFactory.openSession(); try { session.beginTransaction(); session.save(student); session.getTransaction().commit(); } catch (Exception e) { session.getTransaction().rollback(); throw e; } finally { session.close(); } } /** * 根据学号查询学生返回唯一结果 */ public Student findByStudentNo(String studentNo) { Session session sessionFactory.openSession(); try { String hql from Student where studentNo :studentNo; QueryStudent query session.createQuery(hql, Student.class); query.setParameter(studentNo, studentNo); return query.uniqueResult(); } finally { session.close(); } } /** * 查询状态正常的全部学生 */ public ListStudent listActiveStudents() { Session session sessionFactory.openSession(); try { String hql from Student where status :status; QueryStudent query session.createQuery(hql, Student.class); query.setParameter(status, 1); return query.list(); } finally { session.close(); } } }第一眼可能会想为什么不在 finally 里直接 session.close()而是先判断事务状态——关键在于如果查询方法里没有开启事务调用 rollback 时会抛出 Transaction not successfully started 的异常反而掩盖原始错误所以只做异常抛出与关闭。建议在真实项目中把 openSession 和 close 逻辑抽到一个工具类或者基类里避免每个 DAO 方法都重复这个样板代码。这里的几个方法对应了业务里最常见的插入、单条件查询和列表查询这也是最小例子里最有价值的骨架。参数说明createQuery(hql, Student.class) 第二个参数是结果类型Hibernate 5.2 以后推荐这样写不要用无参版本的 createQuery 再强转那样会得到 unchecked 警告而且在 Hibernate 6 里直接编译报错。3.3 HQL 与原生 SQL 的取舍什么时候用 createNativeQueryDAO 里我刻意用了 HQL 而不是原生 SQL因为 HQL 能利用实体映射自动处理列名返回的是实体对象列表。而你如果遇到复杂的多表关联或数据库特有函数就不得不回到原生 SQL。在 Hibernate 里执行原生 SQL 需要用 createNativeQuery而且默认返回 Object[] 数组这跟 HQL 的返回形态差距很大。给一个常用的例子// 原生 SQL 查询返回一个字段列表 String sql select student_name from student where status ?1; Query query session.createNativeQuery(sql); query.setParameter(1, 1); ListString names query.getResultList();很多老代码里会看到 setParameter(0, 1) 这种写法这是 Hibernate 3/4 时代的旧习惯Hibernate 5 原生 SQL 的参数占位符已经从 0 开始改为从 1 开始。这里翻车的概率很高从旧项目拼接过来的代码看到 INDEX 越界别急着怀疑数据库先检查占位符编号。另外原生 SQL 查询出来的是数据库表和列的原始名字如果你在实体里做了 Column 映射这段查询结果不会自动转成实体属性这是和 HQL 最大的逻辑差异。4. Service 事务与 REST 接口最小闭环的组装细节、Transactional 的边界4.1 Service 层事务放在这里而不是 Controller回滚边界这样设要组装出一个能启动并且能够验证的闭环Service 层不能少。Hibernate 的 Session 是线程不安全的一个请求在 Controller 里如果多次操作数据库每一次 openSession 都会创建一个新 Session一旦中间出错前面已经执行的操作并没有被纳入一个统一事务数据库会出现半成品数据。解决方案是在 Service 方法上加 Transactional让 Spring 的事务管理器把整个方法包进一个事务。注意 Transactional 使用的包名是 org.springframework.transaction.annotation.Transactional不是 javax.transaction.Transactional很多初学 Java 的人会在这里混用。下面是 Service 的实现包含了新增学生、按学号查询、禁用学生三个方法package com.example.service; import com.example.dao.StudentDao; import com.example.entity.Student; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.stereotype.Service; import org.springframework.transaction.annotation.Transactional; import java.time.LocalDateTime; Service public class StudentService { Autowired private StudentDao studentDao; /** * 新增学生 * 事务边界在方法上方法内所有 DAO 操作要么全部成功要么全部回滚 */ Transactional(rollbackFor Exception.class) public Long addStudent(String name, String studentNo) { Student student new Student(name, studentNo, 1, LocalDateTime.now()); studentDao.save(student); return student.getId(); } /** * 根据学号查询 * 查询操作加事务可以减少 Session 的开销但不是必须 */ Transactional(readOnly true) public Student getByStudentNo(String studentNo) { return studentDao.findByStudentNo(studentNo); } /** * 禁用学生实际开发会存在修改状态的操作 * 该演示为了体现事务让 update 和 insert 在同一方法中出现 */ Transactional(rollbackFor Exception.class) public void disableStudent(String studentNo) { Student student studentDao.findByStudentNo(studentNo); if (student ! null) { student.setStatus(0); // 这里故意插入一条同名记录让业务校验失败从而演示回滚 Student newStudent new Student(student.getStudentName(), studentNo _copy, 1, LocalDateTime.now()); studentDao.save(newStudent); throw new RuntimeException(模拟业务异常观察事务回滚); } } }逻辑说明addStudent 方法里只调用了 DAO 的 save但因为 save 内部自己开了一个事务如果 Service 不加 Transactional数据库也会写入成功。一旦方法里有两个写操作比如先 update 后 insert在第二个操作抛异常的情况下第一个操作已经被提交数据就脏了。所以事务注解看起来是多余的但它是真实业务中最重要的防线。参数说明rollbackFor Exception.class 意思是任何异常都回滚如果只写 Transactional 不写 rollbackForSpring 只对 RuntimeException 回滚对检查型异常不会回滚。这是 Spring 事务规范里的默认机制但很多人会误以为所有异常都会回滚这里值得踩坑记录。4.2 Controller 层REST 接口与测试方式、返回 JSON 的字段Controller 不需要关心 Session 或事务它只是把 HTTP 请求转成 Service 调用。下面提供一个简单的 REST 接口package com.example.controller; import com.example.entity.Student; import com.example.service.StudentService; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.web.bind.annotation.*; import java.util.HashMap; import java.util.Map; RestController RequestMapping(/api/student) public class StudentController { Autowired private StudentService studentService; /** * 新增学生 * POST /api/student/add?name张三studentNo2024001 */ PostMapping(/add) public MapString, Object add(RequestParam String name, RequestParam String studentNo) { Long id studentService.addStudent(name, studentNo); MapString, Object result new HashMap(); result.put(code, 0); result.put(data, id); return result; } /** * 查询学生 * GET /api/student/get?studentNo2024001 */ GetMapping(/get) public MapString, Object get(RequestParam String studentNo) { Student student studentService.getByStudentNo(studentNo); MapString, Object result new HashMap(); result.put(code, 0); result.put(data, student); return result; } }接口写好之后启动应用尝试访问。启动之前请确认 MySQL 中已经创建了 demo 数据库否则数据源初始化失败。由于 hibernate.hbm2ddl.auto 设置为 update表会自动创建这算是不错的体验。需要特别说一个细节Controller 返回 Student 对象时如果某个字段为 nullJSON 里默认也会输出为 null如果你使用 Fastjson 或 Gson序列化行为可能不同这跟 Hibernate 没直接关系但排错时容易被带偏——看到返回的 JSON 里没有某个字段先检查 Getter 是否存在而不是怀疑 Hibernate 没查出来。常见的测试方式是直接用浏览器访问 GET 接口POST 接口则建议用 Postman 或 curl。curl 的命令可以这样写curl -X POST http://localhost:8080/api/student/add?namezhangsanstudentNo2024001 curl -X GET http://localhost:8080/api/student/get?studentNo2024001这里 name 参数尽量避免用中文测试个别终端环境的 URL 编码问题会干扰判断。在 Windows 的 CMD 里中文参数尤其容易出问题。建议统一用英文或拼音测试跑通后再处理中文编码的展示问题。5. 避坑指南Spring Boot 与 Hibernate 组合的 4 个高频翻车点5.1 启动报错No qualifying bean of type SessionFactory现象Spring Boot 启动时提示 No qualifying bean of type org.hibernate.SessionFactory available。原因HibernateConfig 配置类没有被扫描到或者 LocalSessionFactoryBean 的 Bean 名称与自动配置的冲突导致注入失败。解决确认配置类在启动类所在包或其子包下同时检查是否有多个配置类重复定义 SessionFactory。我的习惯是把启动类放在 com.example 根包所有配置类放在 com.example.config这样天然避免了扫描遗漏。5.2 驱动类报错ClassNotFoundException com.mysql.jdbc.Driver现象启动时无法加载 JDBC Driver。原因MySQL 8.x 的驱动类名从 com.mysql.jdbc.Driver 改成了 com.mysql.cj.jdbc.Driver而很多老项目的 application.properties 里还在用旧类名。解决确认 driver-class-name 是 com.mysql.cj.jdbc.Driver如果你使用 MySQL 5.7 及以下版本可以继续用旧类名但建议统一升级到 8.x 驱动兼容性更好。同时注意 pom.xml 里依赖的 groupId 是 mysql不是 mysql-connector-j 这种新坐标不要混用第一次用完旧坐标后 Maven 可能缓存了错误版本建议依赖更新后强制刷新。5.3 数据表没有自动创建或者只建了一部分表现象程序启动无报错但数据库里找不到 Student 表。原因hibernate.hbm2ddl.auto 配置在 Spring Boot 自动配置时读取的位置不正确。我上面的 examples 里特意写了两种配置路径如果你同时写在了 spring.jpa.properties 和 hibernateProperties 里后者覆盖前者可能导致效果不一致。若没有生效检查是否执行了正确的建表语句。解决最省事的方式是在 application.properties 追加 spring.jpa.hibernate.ddl-autoupdate同时删掉 HibernateConfig 里自定义 properties 的 hbm2ddl.auto避免双份配置互相覆盖。还要注意 MySQL 8 的方言如果不匹配建表时会生成带反引号的保留字student 表名本身没问题但如果表名叫 group 或 order就会踩这个坑。5.4 LazyInitializationException 延迟加载异常与 Session 关闭的冲突现象在 Controller 层获取实体后访问其关联集合抛 LazyInitializationException。原因DAO 方法执行完已经关闭了 Session实体的关联属性处于未初始化状态在 Session 关闭后再访问懒加载属性就会触发异常。解决最直接的方案是不用懒加载或者提前初始化关联对象在事务方法内完成关联数据的访问。对最小例子来说实体里没有关联属性所以不会触发但一旦扩展成有 OneToMany 或 ManyToOne 的真实业务这个问题几乎必现。建议在 Service 方法内把需要的关联数据查询完整不要让懒惰加载泄漏到 Service 之外。如果项目已经到处都是这种代码临时手段是设置 hibernate.enable_lazy_load_no_transtrue但这只是救火会让查询翻倍且行为不可预测不建议长期用。6. 验证与进阶把最小例子变成可维护工程的 3 个关键改进从最小闭环到能交付的老项目维护验证是第一步。你可以在启动日志里看到 Hibernate 打印的建表语句再通过 curl 请求新增学生和查询学生接口确认返回正常后进入下一步把这种示例代码变成团队里其他人也能维护的代码。第一个改进是引入第三方连接池正确做法是替换为 HikariCP 或 c3p0而不是依赖 Hibernate 内置连接管理。Spring Boot 默认使用 HikariCP但因为我们手动声明了 DataSource这个默认配置就绕开了。如果你只是想快速验证继续用 DriverManagerDataSource 没问题如果是多人使用的内部系统建议换用 HikariCP并在配置里设置 maximum-pool-size 与 minimum-idle。例如spring.datasource.hikari.maximum-pool-size20 spring.datasource.hikari.minimum-idle5 spring.datasource.hikari.connection-timeout30000第二个改进是日志级别控制。开发阶段把 hibernate.show_sql 设为 true 可以有效观察 SQL但生产环境开着它会拖慢性能并泄漏表结构。更合理的做法是关闭 show_sql把日志级别调整到 debug:logging.level.org.hibernate.SQLdebug logging.level.org.hibernate.type.descriptor.sql.BasicBindertrace这样 SQL 参数值也会输出到日志排查问题时能还原完整的 SQL 执行语句。第三个改进是批处理。如果你要批量插入几千条数据默认的逐条 insert 性能很差。在 Hibernate 配置里加两个参数hibernate.jdbc.batch_size30 hibernate.order_insertstrue注意 IDENTITY 主键策略下 Hibernate 会忽略 JDBC 批量插入必须把主键生成策略改成 SEQUENCE 或 TABLE批处理才真正生效。这是很多人开了 batch_size 却发现速度没变化的核心原因我在一个批量导入场景里测试过用 IDENTITY 加上 batch_size 参数插入 5000 条数据耗时 12 秒改成 SEQUENCE 策略加批处理后耗时降到 3 秒以内差距相当明显。如果你准备把这个例子逐步扩展成生产项目建议建立一套以验证数据一致性为目标的测试习惯每次修改实体映射或 DAO 查询后用一个独立测试类跑真实的 MySQL 操作不要只在 H2 内存库上验证方言差异会让分页和主键策略出现不同的翻车姿势。我把这套最小骨架放在手边作为模板项目用比新起项目时到处复制粘贴要踏实很多。希望帮到你。本文还有配套的精品资源点击获取
参数优化实战：TaoToken 统一 Key 通道下的流式响应与并发调度调优)
