JPA SQLResultSetMapping映射SQL别名失效，求排查问题

我之前也踩过EclipseLink映射的类似坑，你的核心问题出在**@FieldResult的属性名匹配错误**，加上部分字段映射缺失，导致EclipseLink无法正确识别主键和实体字段，才抛出了主键为null的异常。

问题根源分析 #

你当前的@SqlResultSetMapping里写了：

@FieldResult(name = "ID", column = "AID")

这里的name参数对应的是实体类的属性名称，而不是数据库的列名。如果你的实体类A中主键属性是小写的id（比如private Integer id;），那么写name = "ID"就会让EclipseLink找不到对应的属性，直接导致主键映射失败。

另外，你的查询语句中还返回了val字段，但映射里没有声明这个字段的映射规则——虽然EclipseLink可能会尝试默认映射，但显式声明能避免大小写或命名规则带来的意外问题。

修正后的代码示例 #

假设你的实体类A的属性是id（主键）和val，修正后的代码如下：

DDL保持不变

create table A( ID INTEGER DEFAULT NOT NULL AUTO_INCREMENT PRIMARY KEY, VAL VARCHAR(10) );
insert into A (val) values ('val1');
insert into A (val) values ('val2');

修正后的Java实体类

@Entity
@NamedNativeQuery(
    name = "queryall",
    query = "select ID as AID, VAL as AVAL from A", -- 给VAL也加别名，方便统一映射
    resultSetMapping = "mapping"
)
@SqlResultSetMapping(
    name = "mapping",
    entities = @EntityResult(
        entityClass = A.class,
        fields = {
            @FieldResult(name = "id", column = "AID"), -- name对应实体属性id，column对应SQL别名AID
            @FieldResult(name = "val", column = "AVAL") -- 显式映射val字段，避免默认映射的不确定性
        }
    )
)
public class A implements Serializable {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Integer id;
    
    private String val;
    
    // 省略getter、setter和构造方法
}

关键注意事项 #

1. @FieldResult的name必须严格匹配实体属性名：不管数据库列名是什么，name要和你实体类中定义的属性名完全一致（包括大小写）。比如实体属性是id就写name = "id"，是ID就写name = "ID"。
2. 显式映射所有查询返回的字段：即使字段名看起来能默认匹配，也建议显式声明@FieldResult，避免EclipseLink的默认映射规则和你的预期不一致。
3. 验证查询执行：执行查询时使用EntityManager.createNamedQuery("queryall").getResultList()，如果还是有问题，可以开启EclipseLink的SQL日志，查看实际执行的SQL和结果集的字段匹配情况。

额外排查点 #

如果修正后还是有问题，可以检查：

• 实体类的主键注解是否正确（比如@Id和@GeneratedValue的策略是否和H2的自增主键匹配）
• H2数据库的大小写敏感性：H2默认可能对列名大小写不敏感，但确保SQL中的别名和映射中的column参数完全一致

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