Spring Boot中JPA多1:M映射查询DTO触发JpaSystemException问题

问题核心原因 #

你遇到的JpaSystemException异常，本质是JPA无法自动将实体类中的Set<Sanctioned>集合转换为DTO中的Set<SanctionedDto>集合。当直接在JpaRepository方法中返回SncEventDto时，Spring Data的投影机制仅支持简单字段或单对象嵌套映射，无法处理这种跨类型的集合嵌套转换，导致赋值失败。

解决方案 #

方案1：自定义JPQL查询，手动构造DTO #

在Repository接口中编写JPQL语句，明确指定如何从关联实体提取字段并构造嵌套DTO，同时关联查询避免N+1性能问题。

public interface SncEventRepository extends JpaRepository<SncEvent, Long> {

    @Query("""
        SELECT new com.yourpackage.dto.SncEventDto(
            se.id,
            se.eventName,
            se.venue,
            se.startTime,
            se.endTime,
            se.registrationCost,
            se.registrationDeadline,
            CAST(COLLECT(new com.yourpackage.dto.SanctionedDto(
                sc.boatClass.id,
                sc.boatClass.className,
                sc.sanctioned
            )) AS java.util.Set)
        )
        FROM SncEvent se
        LEFT JOIN se.boats sc
        WHERE se.venue = :venue
        GROUP BY se.id, se.eventName, se.venue, se.startTime, se.endTime, se.registrationCost, se.registrationDeadline
    """)
    Optional<SncEventDto> findByVenue(@Param("venue") String venue);
}

注意：替换com.yourpackage.dto为实际的DTO包路径；CAST(COLLECT(...) AS java.util.Set)用于将JPQL集合转换为Java Set类型，避免类型不匹配。

方案2：先查实体，再手动/自动映射到DTO（更易维护） #

先查询SncEvent实体，再将实体及其关联数据转换为DTO。可选择手动编写转换逻辑，或用MapStruct自动生成映射代码。

手动转换示例

// Repository接口返回实体
public interface SncEventRepository extends JpaRepository<SncEvent, Long> {
    Optional<SncEvent> findByVenue(String venue);
}

// 转换方法（可放在业务类或工具类中）
public SncEventDto convertToDto(SncEvent event) {
    if (event == null) return null;
    
    Set<SanctionedDto> sanctionedDtos = event.getBoats().stream()
            .map(sanctioned -> new SanctionedDto(
                    sanctioned.getBoatClass().getId(),
                    sanctioned.getBoatClass().getClassName(),
                    sanctioned.getSanctioned()
            ))
            .collect(Collectors.toSet());
    
    return new SncEventDto(
            event.getId(),
            event.getEventName(),
            event.getVenue(),
            event.getStartTime(),
            event.getEndTime(),
            event.getRegistrationCost(),
            event.getRegistrationDeadline(),
            sanctionedDtos
    );
}

// 使用方式
Optional<SncEvent> eventOpt = sncEventRepository.findByVenue("目标场地");
Optional<SncEventDto> dtoOpt = eventOpt.map(this::convertToDto);

MapStruct自动映射示例

1. 添加Maven依赖：

<dependency>
    <groupId>org.mapstruct</groupId>
    <artifactId>mapstruct</artifactId>
    <version>1.5.5.Final</version>
</dependency>
<dependency>
    <groupId>org.mapstruct</groupId>
    <artifactId>mapstruct-processor</artifactId>
    <version>1.5.5.Final</version>
    <scope>provided</scope>
</dependency>

2. 编写映射接口：

@Mapper(componentModel = "spring")
public interface SncEventMapper {
    SncEventMapper INSTANCE = Mappers.getMapper(SncEventMapper.class);

    @Mapping(source = "boats", target = "boats")
    SncEventDto toDto(SncEvent sncEvent);

    @Mapping(source = "boatClass.id", target = "boatClassId")
    @Mapping(source = "boatClass.className", target = "boatClassClassName")
    SanctionedDto toSanctionedDto(Sanctioned sanctioned);
}

3. 使用方式：

Optional<SncEvent> eventOpt = sncEventRepository.findByVenue("目标场地");
Optional<SncEventDto> dtoOpt = eventOpt.map(SncEventMapper.INSTANCE::toDto);

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