如何将一个实体映射到两张表？JPA@JoinTable实现疑问

核心结论 #

不能仅通过@JoinTable实现单个实体映射两张不同schema的表。JPA中@Entity注解的类是与特定数据库表（包含schema）绑定的，@JoinTable仅用于定义关联关系的中间表，无法改变实体本身的表映射规则——这也是你当前报错的根本原因：Settings实体被固定绑定到company.settings表，但User关联时实际需要访问user schema下的对应表，导致JPA找不到目标表。

可行解决方案（除你已知的继承/单表存储外） #

1. 基于@MappedSuperclass的复用式继承（推荐） #

创建抽象父类封装共享字段和逻辑，子类分别绑定不同schema的表，既实现代码复用，又符合JPA规范：

// 抽象父类，仅定义映射逻辑，不标注@Entity
@MappedSuperclass
public abstract class BaseSettings {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    private String key;
    private String value;
    // 其他共享字段、getter/setter
}

// 绑定company schema的Settings表
@Entity
@Table(schema = "company", name = "settings")
public class CompanySettings extends BaseSettings {}

// 绑定user schema的Settings表
@Entity
@Table(schema = "user", name = "settings")
public class UserSettings extends BaseSettings {}

然后在关联实体中分别使用对应的子类：

@Entity
@Table(schema = "company")
public class Company {
    @Id
    private Long id;
    
    @ManyToMany
    @JoinTable(
        schema = "company",
        name = "company_settings",
        joinColumns = @JoinColumn(name = "company_id"),
        inverseJoinColumns = @JoinColumn(name = "settings_id")
    )
    private Set<CompanySettings> settings;
}

@Entity
@Table(schema = "user")
public class User {
    @Id
    private Long id;
    
    @ManyToMany
    @JoinTable(
        schema = "user",
        name = "user_settings",
        joinColumns = @JoinColumn(name = "user_id"),
        inverseJoinColumns = @JoinColumn(name = "settings_id")
    )
    private Set<UserSettings> settings;
}

2. Hibernate动态表名映射（特定框架方案） #

如果使用Hibernate作为JPA实现，可以通过自定义PhysicalNamingStrategy或会话级属性动态指定表名，但这种方式复杂度较高，需要根据上下文（比如当前操作的是Company还是User）切换schema和表名，仅适合复杂场景，不推荐作为常规方案。

3. 投影查询（只读场景） #

如果仅需要读取数据，不需要持久化操作，可以用接口投影或DTO将不同schema表的数据映射到同一个Settings类，但这种方式不支持实体的增删改操作：

// 投影接口
public interface SettingsProjection {
    Long getId();
    String getKey();
    String getValue();
}

// 在Repository中查询不同schema的表
@Repository
public interface CompanySettingsRepository extends JpaRepository<CompanySettings, Long> {
    @Query(value = "SELECT id, key, value FROM company.settings", nativeQuery = true)
    List<SettingsProjection> findAllCompanySettings();
}

@Repository
public interface UserSettingsRepository extends JpaRepository<UserSettings, Long> {
    @Query(value = "SELECT id, key, value FROM user.settings", nativeQuery = true)
    List<SettingsProjection> findAllUserSettings();
}

总结 #

最简洁且符合JPA规范的方案是基于@MappedSuperclass的继承模式，它既实现了代码复用，又能清晰绑定不同schema的表，完美解决你的需求。

内容的提问来源于stack exchange，提问作者Самир Шахмурадлы