能否在包含目标与关联字段的子类上使用@JoinTable？

首先直接给结论：如果你的中间表（team_reference_persons）只有两个外键字段，是可以在关联实体（比如Team或Person）上使用@JoinTable的，但你的场景里中间表还有额外字段uses_telephone，这时候单纯的@JoinTable+@ManyToMany就满足不了需求了——因为JPA默认的多对多映射不支持中间表的额外属性。

正确的做法：使用关联实体映射中间表 #

你需要创建一个专门的关联实体（比如TeamPerson）来映射team_reference_persons表，然后让Team和Person分别与这个关联实体建立一对多关系。具体代码示例如下：

1. 定义关联实体TeamPerson

这个实体需要处理复合主键（team_id+person_id），同时映射额外字段uses_telephone：

@Entity
@Table(name = "team_reference_persons")
@IdClass(TeamPersonId.class) // 使用IdClass定义复合主键
public class TeamPerson {
    @Id
    @ManyToOne
    @JoinColumn(name = "team_id")
    private Team team;

    @Id
    @ManyToOne
    @JoinColumn(name = "person_id")
    private Person person;

    @Column(name = "uses_telephone")
    private Boolean usesTelephone;

    // 构造方法、getter、setter省略
}

// 复合主键类，必须实现Serializable
public class TeamPersonId implements Serializable {
    private Integer team;
    private Integer person;

    // 构造方法、equals、hashCode省略
}

你也可以用@EmbeddedId来实现复合主键，写法略有不同，但效果一致。

2. 修改Team实体的关联映射

把原来的@OneToMany（或@ManyToMany）改成关联到TeamPerson：

@Entity
@Table(name = "team")
public class Team {
    @Id
    private Integer id;
    private String name;

    @OneToMany(mappedBy = "team", cascade = CascadeType.ALL, orphanRemoval = true)
    private List<TeamPerson> teamPersons = new ArrayList<>();

    // 方便添加关联的辅助方法
    public void addPerson(Person person, Boolean usesTelephone) {
        TeamPerson teamPerson = new TeamPerson();
        teamPerson.setTeam(this);
        teamPerson.setPerson(person);
        teamPerson.setUsesTelephone(usesTelephone);
        teamPersons.add(teamPerson);
        person.getTeamPersons().add(teamPerson);
    }

    // getter、setter省略
}

3. 修改Person实体的关联映射

同样关联到TeamPerson：

@Entity
@Table(name = "person")
public class Person {
    @Id
    private Integer id;
    private String name;

    @OneToMany(mappedBy = "person", cascade = CascadeType.ALL, orphanRemoval = true)
    private List<TeamPerson> teamPersons = new ArrayList<>();

    // getter、setter省略
}

关于“在包含目标字段与关联字段的子类上使用@JoinTable”的补充 #

如果你的“子类”指的是继承自Person或Team的子类（比如Employee extends Person），那也是可以在子类上使用@JoinTable的，但需要注意继承策略（比如@Inheritance的配置），确保关联表的外键能正确映射到子类的主键。不过结合你的场景，因为中间表有额外字段，还是建议用上面的关联实体方案。

总结一下：

• 纯关联中间表（无额外字段）：可以直接用@ManyToMany+@JoinTable在关联实体上配置
• 带额外字段的中间表：必须通过关联实体来映射，拆分两个@OneToMany关系

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