Spring Data JPA实体指定schema无效，仍查询默认库问题排查

以下是可能导致@Table(schema="schema2")不生效的原因及解决方法：

• 检查JPA实现的方言与属性配置
  若使用Hibernate，全局配置的spring.jpa.properties.hibernate.default_schema=schema1可能会覆盖实体类上的schema指定。针对不同数据库有不同处理：

  • 对于MySQL这类将schema等同于database的数据库，尝试将@Table的schema属性替换为catalog，即@Table(catalog="schema2", name="table1")；
  • 若必须保留全局default_schema配置，可添加spring.jpa.properties.hibernate.allow_update_outside_transaction=true（部分Hibernate版本需此配置来允许实体级schema覆盖全局设置）。

• 验证数据库用户权限
  确保连接数据库的用户拥有schema2的访问权限，能查询、操作table1。若用户无schema2权限，JPA会默认回退到默认schema查找，表现为在schema1中寻找table1。

• 确认实体注解正确性

  • 确保使用的是标准JPA的javax.persistence.Table（Jakarta EE环境为jakarta.persistence.Table），而非其他框架的同名注解；
  • 检查注解属性拼写，避免schema拼写错误；
  • 排查是否存在全局配置类、@EntityScan或自定义命名策略覆盖了实体的schema设置。

• 检查自定义命名策略
  若配置了物理命名策略（如spring.jpa.hibernate.naming.physical-strategy），需确保该策略没有忽略实体上指定的schema属性，避免自动生成表名时丢弃schema2的设置。

• 查看实际执行SQL
  开启SQL日志验证生成的语句：

  spring.jpa.show-sql=true
  spring.jpa.properties.hibernate.format_sql=true
  

  通过日志确认JPA是否真的在查询schema1的table1，还是因权限等其他问题导致的报错误解。

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