本文详解如何在 jpa/hibernate 中正确建模含两个同源外键（如 `sender_id` 和 `receiver_id` 指向同一 `users` 表）的关联实体（如好友请求），避免列重复映射错误，并提供可落地的实体设计与双向导航方案。
在社交类应用中，好友请求（friend_request）是一个典型的带业务属性的关联实体——它不仅表达用户之间的关系，还承载状态（如 status: PENDING/ACCEPTED/REJECTED）、时间戳、备注等上下文信息。此时，简单使用 @ManyToMany 自动管理的连接表是不合适的，因为它无法存储额外字段，且难以区分“发起方”与“接收方”。正确的做法是将该关系显式建模为一个独立实体（即 Association Entity），并通过两个 @ManyToOne 关系分别指向 User 实体。
✅ 正确建模：FriendRequest 实体
首先，定义 FriendRequest 实体，明确指定两个外键列名（注意：@JoinColumn.name 指的是当前表中的外键列名，而非被引用表的主键名）：
@Entity(name = "friend_request")
@Table(name = "friend_request")
@Data
@NoArgsConstructor
public class FriendRequest {
@Id
@GeneratedValue(strategy = GenerationType.IDENTITY)
private Long id;
@Column(name = "status", nullable = false, length = 20)
private String status; // e.g., "PENDING", "ACCEPTED", "REJECTED"
@Column(name = "created_at", updatable = false)
@CreationTimestamp
private LocalDateTime createdAt;
@Column(name = "updated_at")
@UpdateTimestamp
private LocalDateTime updatedAt;
// ✅ 正确：外键列名为 sender_id，引用 users.user_id
@ManyToOne(fetch = FetchType.LAZY)
@JoinColumn(name = "sender_id", referencedColumnName = "user_id", nullable = false)
private User sender;
// ✅ 正确：外键列名为 receiver_id，引用 users.user_id
@ManyToOne(fetch = FetchType.LAZY)
@JoinColumn(name = "receiver_id", referencedColumnName = "user_id", nullable = false)
private User receiver;
}? 关键点：@JoinColumn(name = "sender_id") 中的 "sender_id" 必须与数据库表 friend_request.sender_id 列名完全一致；referencedColumnName = "user_id" 则指明其引用 User 实体对应表（如 users）的主键列名（假设 User 的主键列为 user_id）。若 User 主键为 id，则此处应为 "id"。
✅ 在 User 实体中建立双向导航
在 User 类中，通过 @OneToMany(mappedBy = "...") 声明反向集合，确保 mappedBy 值严格匹配 FriendRequest 中关联字段的属性名（非列名）：
@Entity(name = "user")
@Table(name = "users")
@Data
@NoArgsConstructor
public class User {
@Id
@GeneratedValue(strategy = GenerationType.IDENTITY)
@Column(name = "user_id") // 显式声明主键列名，增强可读性
private Long userId;
@Column(name = "username", unique = true, nullable = false)
private String username;
// ✅ 反向映射：mappedBy = "sender" → 对应 FriendRequest.sender 字段
@OneToMany(mappedBy = "sender", fetch = FetchType.LAZY, cascade = CascadeType.REMOVE, orphanRemoval = true)
private List<FriendRequest> sentRequests = new ArrayList<>();
// ✅ 反向映射：mappedBy = "receiver" → 对应 FriendRequest.receiver 字段
@OneToMany(mappedBy = "receiver", fetch = FetchType.LAZY, cascade = CascadeType.REMOVE, orphanRemoval = true)
private List<FriendRequest> receivedRequests = new ArrayList<>();
}⚠️ 注意事项：
- 勿使用 @ManyToMany：该注解适用于无业务属性的纯连接表，且 Hibernate 会尝试用同一列名（如 user_id）双向映射，导致 Repeated column 错误。
- 避免列名混淆：错误示例中 @JoinColumn(name = "user_id") 试图让 sender 和 receiver 共享同一列，这在数据库层面根本不可行（一个字段不能同时存两个用户ID）。
- 推荐 FetchType.LAZY：防止级联加载引发 N+1 查询；业务中按需调用 sentRequests.size() 或显式 fetch join。
- 级联与孤儿删除：cascade = CascadeType.REMOVE + orphanRemoval = true 可确保删除用户时自动清理其发出/收到的所有请求（按需启用）。
✅ 使用示例：创建好友请求
// 创建请求
FriendRequest request = new FriendRequest();
request.setSender(senderUser); // senderUser 是已加载的 User 实体
request.setReceiver(receiverUser); // receiverUser 是已加载的 User 实体
request.setStatus("PENDING");
friendRequestRepository.save(request);查询某用户所有待处理请求：
List<FriendRequest> pending = friendRequestRepository
.findAllByReceiverAndStatus(receiverUser, "PENDING");✅ 总结
| 场景 | 推荐方式 | 原因 |
|---|---|---|
| 关联表无业务字段（仅 ID 对） | @ManyToMany + @JoinTable | 简洁，由 Hibernate 自动维护 |
| 关联表含业务字段（如状态、时间、备注）或需区分角色（sender/receiver） | 独立实体 + 两个 @ManyToOne | 支持丰富语义、灵活查询、符合 DDD 聚合根设计 |
只要确保 @JoinColumn.name 精确对应数据库外键列名，且 mappedBy 指向关联实体中属性名而非列名，即可彻底规避 Repeated column in mapping 和 duplicated in mapping for entity 等典型映射异常。这种模式也天然支持后续扩展，例如添加“请求消息”、“过期时间”或“双向好友关系确认”逻辑。
