Spring Boot中JPA关联查询报错，PostgreSQL运行正常

在Spring Boot应用中尝试通过Inner Join从vehicle和customer表获取指定列，定义了实体类Vehicle、Customer和接收结果的Details类，但JPQL查询报错：

org.hibernate.query.SemanticException: Could not interpret path expression 'Customer.chassis_id'

对应的PostgreSQL原生SQL可正常返回结果：

SELECT vehicle.chassis, customer.first_name, customer.last_name, vehicle.regno, vehicle.customerconsent 
FROM vehicle JOIN customer ON vehicle.chassis = customer.chassis_id;

JPQL是面向实体类和属性的查询语言，并非直接操作数据库表和列名。你在JPQL中使用了数据库的外键列名Customer.chassis_id，但Customer实体类中对应的是vehicle关联属性，JPA无法识别数据库字段名，因此触发报错。

方法1：使用JPQL构造函数查询（推荐） #

利用实体类的关联关系编写JPQL，同时调用Details的构造函数实现结果映射：

@Override
public List<Details> getDetails() {
    // 需指定Details类的完整路径，参数顺序要与构造函数一致
    TypedQuery<Details> theQuery = entityManager.createQuery(
        "SELECT new com.eichers.vehicleapi.entity.Details(v.chassis, c.firstname, c.lastname, v.regno, v.customerconsent) " +
        "FROM Customer c JOIN c.vehicle v",
        Details.class
    );
    return theQuery.getResultList();
}

关键说明： #

• Customer c JOIN c.vehicle v：通过Customer实体的vehicle关联属性进行关联，JPA会自动使用映射的外键chassis_id生成正确的JOIN条件，无需手动编写ON子句。
• new com.eichers.vehicleapi.entity.Details(...)：显式调用Details的构造函数，将查询字段按顺序传入，JPA会自动将结果映射为Details对象。

方法2：使用原生SQL查询 #

若更习惯原生SQL，可直接使用JPA的原生查询功能，同时指定结果映射到Details类：

@Override
public List<Details> getDetails() {
    Query query = entityManager.createNativeQuery(
        "SELECT v.chassis, c.first_name AS firstname, c.last_name AS lastname, v.regno, v.customerconsent " +
        "FROM vehicle v JOIN customer c ON v.chassis = c.chassis_id",
        Details.class
    );
    return (List<Details>) query.getResultList();
}

关键说明： #

• 需给数据库列名起别名，确保与Details类的属性名一致（如first_name AS firstname），这样JPA才能正确映射字段。
• 原生SQL直接操作数据库表和列，逻辑与你已验证的PostgreSQL语句完全一致。

• 可在Vehicle实体中添加双向关联（可选）：如果需要从Vehicle端访问Customer，可在Vehicle类中添加@OneToOne(mappedBy = "vehicle")的Customer属性，让关联关系更完整。
• 使用Spring Data JPA简化代码：在Repository接口上直接定义查询，无需手动创建TypedQuery：

@Query("SELECT new com.eichers.vehicleapi.entity.Details(v.chassis, c.firstname, c.lastname, v.regno, v.customerconsent) FROM Customer c JOIN c.vehicle v")
List<Details> getDetails();

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