在Hibernate 5+中，无需为每个@Entity类手动添加标签；可通过包扫描机制自动注册实体，大幅提升配置效率与可维护性。
在hibernate 5+中，无需为每个@entity类手动添加
在传统Hibernate项目中，开发者常习惯在 hibernate.cfg.xml 中逐个声明实体类，例如：
<mapping class="com.example.erp.models.Users"></mapping><mapping class="com.example.erp.models.Orders"></mapping><mapping class="com.example.erp.models.Products"></mapping><!-- …… 每增一个实体就要加一行 -->
这种方式虽直观，但极易引发配置遗漏、维护成本高、易出错等问题——尤其当项目实体数达数十甚至上百时，不仅冗余，还违背“约定优于配置”原则。
✅ 推荐方案：启用自动包扫描（Package Scanning）
Hibernate 5.0+ 原生支持通过 <property></property> 配置指定扫描包路径，由 SessionFactory 自动发现并注册所有带 @Entity（及 @Embeddable、@MappedSuperclass 等）注解的类。只需在 hibernate.cfg.xml 的 <session-factory></session-factory> 内添加：
<property name="hibernate.archive.autodetection">class,hbm</property><property name="hibernate.packagesToScan">com.example.erp.models</property>
-
hibernate.archive.autodetection：控制扫描类型，class表示扫描注解类，hbm表示扫描.hbm.xml映射文件（二者可共存）； -
hibernate.packagesToScan：指定需扫描的Java包路径（支持逗号分隔多个包，如com.example.erp.models,com.example.erp.entities）。
✅ 注意：该机制依赖类路径扫描（Classpath Scanning），要求实体类位于
classpath下（如src/main/resources或src/main/java编译输出目录），且不能被jar中的重复包名干扰。
? 替代方案（适用于无XML配置场景）：程序化配置（Hibernate 6+ 推荐）
Hibernate 6 已正式弃用 hibernate.cfg.xml，官方推荐使用 Configuration API 进行代码级配置：
Configuration configuration = new Configuration();
configuration.setProperty("hibernate.dialect", "org.hibernate.community.dialect.SQLiteDialect");
configuration.setProperty("hibernate.connection.url", "jdbc:sqlite:fuelvalley.sqlite");
configuration.setProperty("hibernate.hbm2ddl.auto", "update");
configuration.setProperty("hibernate.show_sql", "true");
// 启用包扫描（等效于 hibernate.packagesToScan）
configuration.addPackage("com.example.erp.models");
// 或直接注册单个类（兼容旧习惯）
// configuration.addAnnotatedClass(Users.class);
SessionFactory sessionFactory = configuration.buildSessionFactory();
⚠️ 注意事项与避坑指南：
-
Spring Boot 用户请忽略 XML 配置：若使用 Spring Boot + Spring Data JPA，完全无需
hibernate.cfg.xml——@EntityScan("com.example.erp.models")或默认包扫描（主启动类所在包及其子包）已自动完成全部注册； -
避免扫描范围过宽：不建议设为
com.example根包，可能引入非实体类或测试类，导致启动失败或元数据污染； -
混合模式需谨慎：同时启用
packagesToScan和显式<mapping class></mapping>可能引发重复注册警告（DuplicateMappingException），应统一策略； -
Hibernate 6 兼容性提示：
hibernate.cfg.xml在 Hibernate 6 中已被移除，迁移时务必改用hibernate.properties或 Java 配置。
? 总结：
手动逐个 <mapping class></mapping> 是 Hibernate 3/4 时代的遗留实践。现代开发中，启用 hibernate.packagesToScan 是标准、安全、可扩展的首选方式。它降低配置耦合度，提升工程健壮性，并为后续升级至 Hibernate 6 或 Spring Boot 架构平滑铺路。
