Spring Boot笔记应用多对多Rest API关联查询异常问题

1. 检查实体类多对多映射配置 #

确保Note和Category的多对多映射注解与数据库中间表完全匹配，同时注意加载策略的影响：

正确的实体配置示例 #

@Entity
public class Note {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    private String title;
    private String content;

    // 配置多对多关联，指定中间表及关联字段
    @ManyToMany(fetch = FetchType.LAZY) // 懒加载为默认，大数据量场景优先使用
    @JoinTable(
        name = "note_category", // 中间表名称需与数据库一致
        joinColumns = @JoinColumn(name = "note_id"), // 当前实体在中间表的外键
        inverseJoinColumns = @JoinColumn(name = "category_id") // 关联实体在中间表的外键
    )
    private Set<Category> categories = new HashSet<>();

    // getter、setter
    public Set<Category> getCategories() {
        return categories;
    }
}

@Entity
public class Category {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    private String name;

    @ManyToMany(mappedBy = "categories") // 关联Note中的categories属性，由Note维护关联关系
    private Set<Note> notes = new HashSet<>();

    // getter、setter
}

2. 解决懒加载未初始化问题 #

默认懒加载（FetchType.LAZY）下，事务结束后访问关联集合会因Session关闭无法加载数据，可通过以下方式处理：

方式一：用JOIN FETCH一次性加载关联数据 #

在Repository中编写JPQL查询，主动加载Note和关联的Categories：

public interface NoteRepository extends JpaRepository<Note, Long> {
    @Query("SELECT n FROM Note n JOIN FETCH n.categories WHERE n.id = :id")
    Optional<Note> findByIdWithCategories(@Param("id") Long id);
}

方式二：事务内主动触发加载 #

确保服务层方法被事务包裹，手动初始化关联集合：

@Service
@Transactional
public class NoteService {
    @Autowired
    private NoteRepository noteRepository;

    public NoteDTO getNoteById(Long id) {
        Note note = noteRepository.findById(id)
                .orElseThrow(() -> new RuntimeException("Note not found"));
        // 初始化懒加载的categories集合
        Hibernate.initialize(note.getCategories());
        return convertToDTO(note);
    }
}

3. 检查DTO转换逻辑 #

确认实体转DTO时，正确提取了分类ID，避免空指针或遗漏转换：

public class NoteDTO {
    private Long id;
    private String title;
    private String content;
    private List<Long> categoryIds;

    public static NoteDTO fromEntity(Note note) {
        NoteDTO dto = new NoteDTO();
        dto.setId(note.getId());
        dto.setTitle(note.getTitle());
        dto.setContent(note.getContent());
        
        // 提取分类ID，空集合而非null
        if (note.getCategories() != null && !note.getCategories().isEmpty()) {
            dto.setCategoryIds(note.getCategories().stream()
                    .map(Category::getId)
                    .collect(Collectors.toList()));
        } else {
            dto.setCategoryIds(new ArrayList<>());
        }
        return dto;
    }
}

4. 验证中间表数据 #

确认数据库中间表note_category中，目标Note对应的note_id和category_id关联数据存在且正确。

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