Spring中@PersistenceContext注解的unitName属性应填什么

首先直接给结论：unitName填写的不是待连接的数据库名称，它对应的是JPA规范中定义的「持久化单元（Persistence Unit）」的唯一标识名。

分场景说明填写方式 #

• 单数据源场景（绝大多数Spring Boot初学者接触的入门场景）
  你完全不需要配置unitName属性，甚至不需要给@PersistenceContext加任何参数。Spring Boot的JPA自动配置会默认创建一个名为default的持久化单元，直接按下面的写法注入就能正常使用：

  @PersistenceContext
  private EntityManager entityManager;
  

  就算你硬要把unitName写上，填default也能正常运行，但属于多此一举。
• 多数据源场景（一个项目连接多个数据库）
  这时候你需要为每个数据源单独配置对应的持久化单元，每个持久化单元可以自定义一个唯一的名字，unitName就填你自定义的这个名字，用来指定当前要注入哪个持久化单元对应的EntityManager实例。
  举个实际配置的例子：如果你给订单库、用户库两个数据源分别定义了持久化单元名orderDb、userDb，注入的时候就要对应写：

  // 注入操作订单库的EntityManager
  @PersistenceContext(unitName = "orderDb")
  private EntityManager orderEm;
  
  // 注入操作用户库的EntityManager
  @PersistenceContext(unitName = "userDb")
  private EntityManager userEm;
  

常见误区提醒 #

持久化单元是JPA层面的逻辑配置集合，它会关联对应数据源、扫描到的实体类、JPA运行参数，但它本身既不是数据库里的库名，也不是你注册到Spring容器中的DataSource类型Bean的名称，不要把几个概念搞混。单数据源开发时完全不需要关心这个参数，直接无参注入EntityManager即可。

内容的提问来源于stack exchange，提问作者Qwerty