Micronaut JDBC多对多关系异常：保存项目后关联表无数据

问题场景 #

使用Micronaut Data JDBC 3.9.3 + PostgreSQL，创建多对多关系时，Project实体成功保存至数据库，但关联表project_user中没有生成任何关联记录。

SQL表结构 #

CREATE TABLE project
(
    id          SERIAL PRIMARY KEY,
    ...
);

CREATE TABLE user
(
    id    SERIAL PRIMARY KEY,
    ....
);

CREATE TABLE project_user
(
    user_id    INTEGER REFERENCES user (id),
    project_id INTEGER REFERENCES project (id),
    CONSTRAINT users_projects_pk PRIMARY KEY (user_id, project_id)
);

Java实体类代码 #

User类

public class User {
    @Id
    @GeneratedValue
    private Integer id;
    ....

    @Relation(value = Relation.Kind.MANY_TO_MANY, mappedBy = "users")
    private Set<Project> projects = Collections.emptySet();
}

Project类

public class Project {
    @Id
    @GeneratedValue
    private Integer id;
    ...
    @Relation(value = Relation.Kind.MANY_TO_MANY)
    @JoinTable(
        name = "project_user",
        joinColumns = @JoinColumn(name = "project_id"),
        inverseJoinColumns = @JoinColumn(name = "user_id"))
    @JsonIgnore
    private Set<User> users;
}

使用示例代码 #

var users = userRepository.findByIdInList(userIdList);

Project project = Project.builder()
    .users(users)
    .build();
project = projectRepository.save(project);

问题原因与解决步骤 #

• 添加@MappedEntity注解到实体类
  Micronaut Data JDBC需要实体类标注@MappedEntity才能识别为持久化对象，否则不会处理关联关系的持久化。给User和Project类都加上该注解：

  @MappedEntity
  public class User {
      // 原有代码保持不变
  }
  
  @MappedEntity
  public class Project {
      // 原有代码保持不变
  }
  

• 初始化关联集合为可修改实例
  当前User类的projects使用了不可变的Collections.emptySet()，Project类的users未初始化，这会导致框架无法向集合中添加关联数据。建议初始化为HashSet：

  // User类中修改集合初始化
  @Relation(value = Relation.Kind.MANY_TO_MANY, mappedBy = "users")
  private Set<Project> projects = new HashSet<>();
  
  // Project类中修改集合初始化
  @Relation(value = Relation.Kind.MANY_TO_MANY)
  @JoinTable(...)
  @JsonIgnore
  private Set<User> users = new HashSet<>();
  

• 尝试使用saveAndFlush方法
  部分场景下save方法不会立即触发关联表的写入，使用saveAndFlush可以强制刷新持久化上下文，确保关联数据被写入：

  project = projectRepository.saveAndFlush(project);
  

• 检查Repository接口定义
  确保projectRepository和userRepository正确继承自Micronaut Data的Repository接口，例如：

  @Repository
  public interface ProjectRepository extends JdbcRepository<Project, Integer> {
  }
  
  @Repository
  public interface UserRepository extends JdbcRepository<User, Integer> {
      List<User> findByIdInList(List<Integer> userIdList);
  }
  

补充说明 #

Micronaut Data JDBC中，多对多关系的控制权在未标注mappedBy的一方（即Project类），保存时关联的User实体必须是已持久化的状态（你的代码中从数据库查询users的操作是符合要求的），核心问题集中在实体的注解配置和集合的可修改性上。

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