hbm.xml 是 Hibernate 早期用于 ORM 映射的 XML 文件，定义类与表、属性与字段、主键策略及关联关系；结构以 为根，含 、、 等元素，需在配置中注册加载。
hbm.xml 是 Hibernate 早期版本中用于定义对象关系映射（ORM）的 XML 配置文件，虽然现在主流用注解（@Entity、@Id 等）或 JPA 标准方式，但老项目、遗留系统或特定场景下仍需维护或编写 hbm.xml 文件。它的核心作用是告诉 Hibernate：Java 类怎么对应数据库表，属性怎么映射字段，主键怎么生成，关联关系如何处理。
基础结构：一个最简 hbm.xml 文件长什么样
每个 hbm.xml 文件通常对应一个实体类，以 <hibernate-mapping></hibernate-mapping> 为根元素。下面是一个典型的 User.hbm.xml 示例：
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE hibernate-mapping PUBLIC
"-//Hibernate/Hibernate Mapping DTD 3.0//EN"
"http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd">
<hibernate-mapping package="com.example.model">
<class name="User" table="t_user">
<id name="id" column="id">
<generator class="native"/>
</id>
<property name="username" column="username" type="string"/>
<property name="email" column="email" type="string"/>
</class>
</hibernate-mapping>
说明：
– package 属性可省略，但设上后，name="User" 就不用写全限定名；
– <id></id> 定义主键，<generator></generator> 指定 ID 生成策略（如 native、increment、uuid、assigned）；
– <property></property> 映射普通属性，默认类型由 Hibernate 推断，显式写 type 更安全（如 integer、timestamp、text）。
常用映射细节：字段类型、空值、长度与唯一性
实际开发中，光靠 name 和 column 不够，还需控制数据库行为和 Java 层约束：
-
指定 SQL 类型和长度：用
type（Hibernate 类型）+length+not-null，例如：<property name="phone" column="phone" type="string" length="15" not-null="true"></property> -
映射时间字段：推荐用
type="timestamp"（对应 java.util.Date 或 LocalDateTime，需配合方言支持）；
若只存日期，可用type="date"；只存时间用type="time"。 -
大文本字段（如 CLOB）：写
type="text"，Hibernate 会自动映射为String并适配数据库的长文本类型（如 MySQL 的 TEXT、Oracle 的 CLOB）。 -
布尔值映射：用
type="boolean"，底层按TINYINT(1)或CHAR(1)存（取决于方言），也可用type="yes_no"或type="true_false"控制存储值。
配置关联关系：一对多、多对一怎么写
关联是 hbm.xml 的重点也是难点。以“用户（User）→ 订单（Order）”的一对多为例：
在 User.hbm.xml 中声明集合：
在调试 Java 后端 API 故障时使用此技能，尤其适用于以下任务：分析日志、跨 Controller、Service 和 Mapper 层追踪请求、定位异常根因、检查 SQL 执行或参数流转，以及生成简洁的诊断结论与修复方案。
<set name="orders" cascade="save-update" inverse="true">
<key column="user_id"/>
<one-to-many class="Order"/>
</set>
在 Order.hbm.xml 中声明外键引用：
<many-to-one name="user" class="User" column="user_id" not-null="true"/>
关键点：
– cascade 控制级联操作（如 save-update 表示保存 User 时自动保存其 orders）；
– inverse="true" 表示“这一端不负责维护关联”，即由 many-to-one 端（Order）来更新外键，避免重复 SQL；
– <key></key> 指定外键列名，必须和 many-to-one 的 column 一致；
– 如果 Order 类里没有 user 属性，就只能单向映射（仅在 User 里配 <set></set>），但不推荐，易出错。
注册与加载：让 Hibernate 找到你的 hbm.xml
光写好文件还不够，得让 SessionFactory 加载它。常见方式有两种：
-
在 hibernate.cfg.xml 中逐个声明：
<mapping resource="com/example/model/User.hbm.xml"></mapping><mapping resource="com/example/model/Order.hbm.xml"></mapping> -
使用 Spring 配置（如 applicationContext.xml）：
<property name="mappingResources"><br> <list><br> <value>com/example/model/User.hbm.xml</value><br> <value>com/example/model/Order.hbm.xml</value><br> </list><br> </property>
注意路径要和 classpath 下的实际位置一致（一般放在 src/main/resources 对应包路径下），且文件名建议与类名一致，避免混淆。
基本上就这些。hbm.xml 不复杂但容易忽略细节——比如 generator 写错导致 ID 为空、inverse 设反引发外键更新失败、type 类型不匹配造成查询异常。写完建议配合日志（show_sql=true）看生成的 SQL 是否符合预期，再结合单元测试验证增删改查逻辑。
