persistence.xml 在现代 Spring Boot 项目中基本不用，因其被自动配置接管，不仅不生效还可能干扰初始化，仅适用于纯 Java EE 或传统 Spring XML 项目。
为什么 persistence.xml 在现代 Spring Boot 项目里基本不用了
Spring Boot 默认用自动配置接管 JPA，persistence.xml 不仅不生效，还可能干扰 DataSource 和 EntityManagerFactory 的初始化。它只在纯 Java EE 或传统 Spring XML 配置项目中起作用。
常见错误现象：java.lang.IllegalStateException: No persistence units found，其实是 Spring Boot 检测到 META-INF/persistence.xml 后尝试按 JPA 规范加载，但没配对的 provider 或 classpath 缺失导致失败。
- Spring Boot 2.7+ 默认忽略
persistence.xml，除非显式设置spring.jpa.properties.javax.persistence.provider=org.hibernate.jpa.HibernatePersistenceProvider - 若你硬要用，必须确保
persistence-unit的name与@PersistenceUnit注解值一致，且class元素列出所有实体（或启用exclude-unlisted-classes=false） - 优先用
application.properties配置：比如spring.jpa.hibernate.ddl-auto=update比在 XML 里写<property name="hibernate.hbm2ddl.auto" value="update"/>更直接、可覆盖
如何让 @Entity 类被 Hibernate 正确扫描到
Hibernate 不会自动扫描整个 classpath 查找实体类，它依赖明确的注册来源：要么是 persistence.xml 中的 class 列表，要么是 Spring Boot 的包扫描机制。
使用场景：新增一个 User 实体后，运行时报 org.hibernate.MappingException: Unknown entity: com.example.User，说明 Hibernate 根本没“看见”它。
立即学习“Java免费学习笔记（深入）”；
- Spring Boot 下，确保
@SpringBootApplication所在类与@Entity类在同一个包或子包下；否则加@EntityScan("com.example.domain") - 避免把
@Entity放在src/test/java下——测试目录默认不参与 JPA 扫描 - 如果用了 Lombok，确认
@Data+@NoArgsConstructor都存在，否则 Hibernate 实例化失败会静默跳过该类（日志里可能只有一行Skipping entity）
spring.jpa.hibernate.ddl-auto 各值的真实行为差异
这个配置不是“开发开关”，而是直接影响数据库结构生命周期的策略，选错会导致数据丢失或迁移失败。
常见错误现象：本地设成 create，上线后清空生产库；或设成 validate，但字段改了类型却没报错——其实是 Hibernate 没校验列类型变更（只校验表/字段存在性）。
-
none：完全禁用 DDL，适合用 Flyway/Liquibase 管理 schema -
validate：只比对表和字段名，不检查长度、精度、是否 nullable；列类型不一致不会报错 -
update：能加字段、加索引，但不能删字段、改类型；线上严禁使用（可能锁表、生成不可逆 SQL） -
create/create-drop：只用于单元测试或临时环境，启动即重建，数据必丢
为什么 EntityManager 注入失败常和事务边界有关
EntityManager 是线程绑定、有上下文生命周期的代理对象，不是简单 new 出来的单例。注入失败往往不是配置问题，而是调用时机不对。
使用场景：在 @PostConstruct 方法里调用 entityManager.find() 报 TransactionRequiredException；或在异步方法（@Async）里用 EntityManager 返回空结果。
-
@PersistenceContext注入的是容器管理的代理，只有在 Spring 管理的 bean、且当前线程有活跃事务时才真正可用 - 非事务方法里想查数据，改用
JdbcTemplate或声明@Transactional(propagation = Propagation.REQUIRED) - 异步任务需要访问数据库，必须手动传播事务上下文，或改用
TransactionTemplate显式控制
