Spring JPA多态投影无法按子类型差异化映射问题求助

看起来你遇到了Spring Data JPA多态投影的常见坑——虽然实体类型识别正确，但投影实例始终是基类投影类型，不会自动切换到子类投影。让我帮你拆解问题并给出可行的解决方案：

问题根源分析 #

你为基类Material和子类LinkMaterial分别定义了同名投影接口，但Spring Data JPA不会自动根据实体的实际类型动态匹配投影接口。当你调用仓库方法时传入DTOMaterial.class，框架只会固定创建该类型的投影代理，完全忽略你为子类定义的投影配置，哪怕实体实际是LinkMaterial类型。

另外还有一个容易忽略的细节：你的DTOLinkMaterial接口里的getURL()方法，和实体类的url字段大小写不匹配（实体是小驼峰url，投影方法是大写URL），这会导致url字段无法被正确投影出来。

解决方案 #

方案1：手动使用ProjectionFactory动态创建投影 #

这是最直接有效的方式，通过ProjectionFactory根据实体实际类型选择对应的投影接口：

1. 修改仓库方法，返回实体列表
   先让仓库返回原始实体，后续手动转换为投影：

@Query(value = "SELECT m from Material m JOIN FETCH m.submissionTasks stm WHERE stm.id.submissionTaskId=:id")
List<Material> getForSubmissionTaskEntities(Long id);

2. 在服务层注入ProjectionFactory，手动转换投影

@Service
public class MaterialService {

    private final MaterialRepository materialRepository;
    private final ProjectionFactory projectionFactory;

    // 构造注入ProjectionFactory
    public MaterialService(MaterialRepository materialRepository, ProjectionFactory projectionFactory) {
        this.materialRepository = materialRepository;
        this.projectionFactory = projectionFactory;
    }

    public List<DTOMaterial> getMaterialDTOsForSubmissionTask(Long id) {
        List<Material> materials = materialRepository.getForSubmissionTaskEntities(id);
        
        return materials.stream()
                .map(material -> {
                    // 根据实体类型选择对应的投影接口
                    if (material instanceof LinkMaterial) {
                        return projectionFactory.createProjection(DTOLinkMaterial.class, material);
                    } else {
                        return projectionFactory.createProjection(DTOMaterial.class, material);
                    }
                })
                .collect(Collectors.toList());
    }
}

3. 修正投影方法名的大小写问题
   把DTOLinkMaterial的方法改成和实体字段匹配的小驼峰：

@Projection(name = "material", types = LinkMaterial.class)
public interface DTOLinkMaterial extends DTOMaterial{
    String getUrl(); // 改成getUrl()而非getURL()
}

方案2：升级Spring Data JPA版本（可选） #

如果你的Spring Data JPA版本较旧（比如2.x之前），新版本（3.x+）对多态投影的支持更完善。不过即使不升级，方案1也能完美解决问题。

验证效果 #

修改后，LinkMaterial类型的实体会被正确转换为DTOLinkMaterial实例，此时instanceof DTOLinkMaterial会返回true，JSON响应里也会包含url字段。

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