Spring中使用DTO查询Classes时Students字段始终为null问题

出现students字段为null的原因主要有3个，对应修复步骤如下：

1. 实体类关联配置错误 #

问题点 #

• Classes实体的@OneToMany注解未指定mappedBy属性，无法建立与Student实体的双向关联映射；
• Classes中集合字段名为单数student，但DTO中是复数students，ModelMapper默认按字段名匹配，导致映射失败。

修复代码 #

修改Classes实体的关联配置与字段名：

@Entity
@Data
@NoArgsConstructor(force = true)
@AllArgsConstructor
public class Classes {
    // 其他字段保持不变
    @OneToMany(mappedBy = "classes")
    private List<Student> students; // 字段名改为复数，与DTO对齐
}

2. JPA懒加载导致集合未初始化 #

问题点 #

默认情况下@OneToMany的加载策略是FetchType.LAZY（懒加载），查询Classes时不会主动从数据库加载关联的Student数据，此时集合是未初始化的代理对象，ModelMapper无法解析出实际数据，最终返回null。

修复方案（二选一） #

方案1：使用JOIN FETCH主动加载关联数据（推荐，性能更优）

在ClassesRepository中编写JPQL查询，通过JOIN FETCH一次性加载关联的Student集合：

@Repository
public interface ClassesRepository extends JpaRepository<Classes, Long> {
    @Query("SELECT c FROM Classes c JOIN FETCH c.students WHERE c.name = :name")
    Classes findByName(@Param("name") String name);
}

方案2：改为立即加载（快速验证用，不推荐全局使用）

修改Classes实体的@OneToMany注解，设置fetch = FetchType.EAGER：

@OneToMany(mappedBy = "classes", fetch = FetchType.EAGER)
private List<Student> students;

3. ModelMapper映射规则验证 #

如果实体与DTO字段名仍有差异（比如后续调整字段名），可以显式配置ModelMapper的映射规则：

@Configuration
public class ModelMapperConfig {
    @Bean
    public ModelMapper modelMapper() {
        ModelMapper modelMapper = new ModelMapper();
        // 显式指定关联字段映射
        modelMapper.typeMap(Classes.class, ClassesGetDto.class)
            .addMapping(Classes::getStudents, ClassesGetDto::setStudents);
        return modelMapper;
    }
}

验证 #

完成上述修改后重启服务，发送GET请求即可获取到正确的students列表数据。

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