在 Spring R2DBC 中，当多对多关联表（如 tutor_student）采用复合主键（如 relation_id + tutor_id）时，需通过 @IdClass 显式声明主键结构，否则 ReactiveCrudRepository.save() 会误判为新记录而执行插入而非更新。
在 spring r2dbc 中，当多对多关联表（如 `tutor_student`）采用复合主键（如 `relation_id` + `tutor_id`）时，需通过 `@idclass` 显式声明主键结构，否则 `reactivecrudrepository.save()` 会误判为新记录而执行插入而非更新。
Spring R2DBC 虽不支持 JPA 的 @EmbeddedId 或生命周期回调，但完全兼容 @IdClass 注解——这是官方推荐的复合主键声明方式。关键在于：主键字段必须同时满足三个条件：
- 在实体类中用 @Id 显式标注每个主键列；
- 所有 @Id 字段必须在 @IdClass 指定的主键类中以完全相同的名称和类型定义；
- 主键类必须实现 Serializable，并提供无参构造器（@NoArgsConstructor）及全参构造器（便于手动构建 ID 实例）。
以下是完整、可运行的配置示例：
// 主键类：必须与实体中 @Id 字段严格匹配
@Getter
@Setter
@NoArgsConstructor
@AllArgsConstructor
public class TutorStudentId implements Serializable {
private Long relationId;
private Long tutorId;
}// 实体类：使用 @IdClass 并标注每个主键字段
@Getter
@Setter
@NoArgsConstructor
@Table("tutor_student")
@IdClass(TutorStudentId.class)
public class TutorStudentEntity {
@Id
@Column("relation_id") // 注意：此处列名是 relation_id，非原问题中的缺失字段
private Long relationId;
@Id
@Column("tutor_id")
private Long tutorId;
@Column("student_id")
private String studentId;
@Column("status")
private String status;
}// 对应的 Repository（无需额外配置）
public interface TutorStudentRepository extends ReactiveCrudRepository<TutorStudentEntity, TutorStudentId> {
}✅ 正确使用后，repository.save(entity) 将自动识别已有主键并执行 UPDATE（基于 relation_id + tutor_id 匹配），而非重复 INSERT。
⚠️ 注意事项：
- 若数据库中 relation_id 和 tutor_id 组合唯一性未建索引或约束，请务必添加 UNIQUE INDEX，否则业务逻辑可能出错；
- @IdClass 中字段顺序不影响 SQL 生成，但建议与实体中 @Id 声明顺序一致，提升可维护性；
- 不要遗漏 @NoArgsConstructor —— R2DBC 反序列化查询结果时依赖无参构造器；
- 若需自动生成 relation_id（如数据库序列），可结合 @GeneratedValue（需驱动支持，PostgreSQL 推荐，H2 需显式配置）。
总结：Spring R2DBC 的复合主键方案简洁可靠，核心是 @IdClass + 多个 @Id 字段的协同声明。它不依赖 ORM 映射层的复杂代理机制，完全契合响应式、无状态的设计哲学，是构建高性能关系型响应式服务的关键实践之一。
