JPA原生查询实体字段多于返回列时如何将缺失列自动赋值为null

报错根因 #

JPA默认将原生查询结果映射到@Entity实体时，会严格校验结果集列名和实体持久化字段的匹配性，缺失任意字段对应的列都会抛出列名无效错误，不会自动为缺失字段填充null。

轻量实现方案（无需大量配置，不影响原有实体复用逻辑） #

方案1：使用JPA规范原生@SqlResultSetMapping构造映射（通用无依赖限制） #

该方案属于JPA标准规范能力，兼容所有JPA实现，无需额外依赖：

1. 为实体类新增对应返回字段组合的构造方法，缺失字段在构造方法中直接赋值为null，保留原有无参、全参构造方法不影响其他模块使用
2. 在实体类上添加@SqlResultSetMapping注解，配置结果集到构造方法的映射规则
   示例代码：

@Entity
@SqlResultSetMapping(
    // 映射名称自定义，多个返回组合可以配置多个mapping
    name = "TestEntityOnlyId2Mapping",
    classes = @ConstructorResult(
        targetClass = TestEntity.class,
        // 按构造方法入参顺序配置返回列，类型和查询返回一致
        columns = {
            @ColumnResult(name = "ID2", type = String.class)
        }
    )
)
public class TestEntity {
    @Id
    private String ID;
    private String ID1;
    private String ID2;
    private String ID3;

    // 原有无参、全参构造方法保留
    public TestEntity() {}
    public TestEntity(String ID, String ID1, String ID2, String ID3) {
        this.ID = ID;
        this.ID1 = ID1;
        this.ID2 = ID2;
        this.ID3 = ID3;
    }

    // 新增适配仅返回ID2场景的构造方法
    public TestEntity(String ID2) {
        this.ID = null;
        this.ID1 = null;
        this.ID2 = ID2;
        this.ID3 = null;
    }
    // 按需添加其他返回组合的构造方法，比如仅返回ID1、ID2的构造方法
}

3. 在查询注解中指定使用的映射名即可：

// 普通原生查询
@Query(value = "SELECT ID2 from DATABASE", nativeQuery = true, resultSetMapping = "TestEntityOnlyId2Mapping")
List<TestEntity> testNativeQuery ();

// 存储过程调用
@Query(value = "STORED_PROC :a, :b", nativeQuery = true, resultSetMapping = "TestEntityOnlyId2Mapping")
List<TestEntity> execStoredProc(@Param("a") String a, @Param("b") String b);

方案2：使用Hibernate结果转换器（更简洁，适配Spring Data JPA默认场景） #

如果你的项目使用Hibernate作为JPA实现（Spring Data JPA默认使用Hibernate），可以直接使用Hibernate提供的结果转换器，无需修改实体类，转换器会自动将结果集缺失的字段赋值为null：

@Repository
public class TestRepository {
    @PersistenceContext
    private EntityManager entityManager;

    public List<TestEntity> execStoredProc(String a, String b) {
        return entityManager.createNativeQuery("STORED_PROC :a, :b")
                .setParameter("a", a)
                .setParameter("b", b)
                // unwrap为Hibernate原生查询对象
                .unwrap(org.hibernate.query.NativeQuery.class)
                // 设置结果转换器，自动映射列名字段，缺失字段设为null
                // Hibernate 5及以下版本用下面的写法
                .setResultTransformer(org.hibernate.transform.AliasedToBeanResultTransformer.newInstance(TestEntity.class))
                // Hibernate 6及以上版本用下面的写法替换上一行
                // .setTupleTransformer((tuple, aliases) -> {
                //     TestEntity entity = new TestEntity();
                //     for (int i = 0; i < aliases.length; i++) {
                //         try {
                //             Field field = TestEntity.class.getDeclaredField(aliases[i]);
                //             field.setAccessible(true);
                //             field.set(entity, tuple.get(i));
                //         } catch (Exception ignored) {}
                //     }
                //     return entity;
                // })
                .getResultList();
    }
}

该方案无需修改原有实体类，新增不同返回字段的查询时不需要额外调整实体结构，更适合多存储过程复用同一实体的场景。

需求实现难度 #

非常低，上述两种方案均只需要少量代码调整，不需要修改原有实体的核心结构，也不影响其他模块对该实体的正常使用，且完全兼容MSSQL数据库和官方驱动。

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