hibernate.cfg.xml文件怎么配置 Hibernate入门教程

配置 hibernate.cfg.xml 是 Hibernate 入门最关键的一步，需严格遵循 DTD 规范，正确设置数据库连接四要素、方言、自动建表策略、SQL 输出及映射声明。

配置 hibernate.cfg.xml 是 Hibernate 入门最关键的一步，它相当于整个 ORM 框架的“启动说明书”。只要把数据库连接、方言、映射关系这几项配对，后续的增删改查就能自动运转。

基础结构不能少

这个 XML 文件必须符合 Hibernate 的 DTD 规范，开头声明和根节点要写全：

• 外层是 ，里面只允许一个

数据库连接四要素必须填对

这是最常出错的部分，四项缺一不可，且名称要带 hibernate. 前缀（新版本推荐）或直接用旧名（如 connection.url），但别混用：

• com.mysql.cj.jdbc.Driver（MySQL 8+ 用 cj，老版本用 com.mysql.jdbc.Driver）
• jdbc:mysql://localhost:3306/testdb?useSSL=false&serverTimezone=UTC&characterEncoding=UTF-8（URL 中务必加时区和编码参数，否则中文乱码或时间异常）
• root
• your_password

核心行为配置决定运行逻辑

这几项不配好，程序可能连表都建不出来，或者 SQL 完全看不到：

• org.hibernate.dialect.MySQL8Dialect（必须和数据库版本匹配，MySQL 5.7 用 MySQL5InnoDBDialect，8.0+ 推荐 MySQL8Dialect）
• update（开发阶段常用：create 每次重建，validate 只校验，none 关闭自动管理）
• true 和 true（调试必备，让控制台输出可读 SQL）
• thread（保证同一线程内 Session 复用，避免频繁 open/close）

映射文件或类要显式声明

Hibernate 不会自动扫描所有类，必须告诉它哪些实体需要管理：

• 用 XML 映射：apping resource="com/example/User.hbm.xml"/>
• 用注解类：
• 可以写多行，每行一个映射项

配完保存为 src/main/resources/hibernate.cfg.xml，确保在 classpath 根路径下。Hibernate 启动时会自动加载它——不需要手动指定路径。