含@Transient字段的JPA实体关联查询报错问题咨询

报错原因 #

你的代码存在三个核心问题导致查询失败：

1. JPQL语法错误：查询语句缺少FROM子句，直接使用JOIN不符合JPQL规范；同时查询中定义的参数@Param("id")未在JPQL中使用，属于冗余定义。
2. 构造函数缺失：OtherEntity没有显式定义接收id和code的构造函数，JPQL中new OtherEntity(o.id, o.code)会因找不到对应构造函数报错。
3. 实体关联逻辑不清晰：查询意图是构造MarkerEntity，但未正确关联MarkerEntity和OtherEntity的关系，导致数据映射逻辑混乱。

修复步骤 #

1. 补充OtherEntity的构造函数 #

给OtherEntity添加带参数的构造函数，同时保留JPA实体必需的无参构造函数：

@Entity
@Table(name = "OTHER")
public class OtherEntity implements Serializable {
    @Id
    private Long id;
   
    @Column(name = "code")
    private String code;

    // 带参数的构造函数，供JPQL调用
    public OtherEntity(Long id, String code) {
        this.id = id;
        this.code = code;
    }

    // JPA实体强制要求的无参构造函数
    public OtherEntity() {}
}

2. 修正JPQL查询语句 #

调整查询语法，补充FROM子句，明确实体关联关系，同时移除冗余参数：
如果需要关联MarkerEntity和OtherEntity表（通过otherId关联），使用以下查询：

@Query("SELECT new MarkerEntity(m.otherId, new OtherEntity(o.id, o.code)) " +
       "FROM MarkerEntity m " +
       "JOIN OtherEntity o ON m.otherId = o.id")
public List<MarkerEntity> entities();

如果需求是直接从OtherEntity构造MarkerEntity（无需关联MarkerEntity表），可以简化为：

@Query("SELECT new MarkerEntity(o.id, new OtherEntity(o.id, o.code)) " +
       "FROM OtherEntity o")
public List<MarkerEntity> entities();

3. 确认MarkerEntity的构造函数合规性 #

确保MarkerEntity保留JPA要求的无参构造函数，且业务构造函数的参数顺序、类型与JPQL调用完全匹配：

@Entity
@Table(name = "MARKER")
public class MarkerEntity implements Serializable {
    @Id
    private Long id;
    
    @Column(name = "OTHER_FIELD")
    private Long otherId;

    @Transient
    private OtherEntity other;

    // 业务构造函数
    public MarkerEntity(Long otherId, OtherEntity other) {
        this.otherId = otherId;
        this.other = other;
    }

    // JPA强制要求的无参构造函数
    public MarkerEntity() {}

    // 按需补充getter/setter方法
}

关键说明 #

• @Transient字段仅表示该字段不映射到数据库表，不影响JPQL中通过构造函数为其赋值的逻辑，只要构造函数参数匹配即可。
• JPA实体必须包含无参构造函数，否则无法被JPA框架实例化。
• JPQL中使用构造函数实例化对象时，必须确保对应的构造函数是public权限，且参数类型、顺序完全匹配。

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