JPA自定义查询中Inner Join语句执行报错，提示Address类型不匹配

开发者阿泽

2026-9-26

问题原因

默认@Query注解使用JPQL（面向实体的查询语言），而非原生SQL。你的Organization实体中address字段是Address实体类型，你直接将其与Address.id的Long类型值做等值判断，类型不匹配，因此抛出错误。
你在SQL编辑器中执行的是原生SQL，直接操作数据库表和实际字段（包括自动生成的address_id外键），但未指定nativeQuery=true的情况下JPA不会将查询语句按原生SQL解析。

解决方案

方案1：使用标准JPQL写法（推荐）

JPQL直接基于实体关联关系查询，不需要手动处理外键：

先定义DTO接收查询返回的指定字段：

// 可放在dto包等合适位置
data class OrgAddressDto(
    val id: Long,
    val name: String,
    val building: String,
    val city: String
)

修改Repository的查询语句和返回值：

interface OrganizationRepository : JpaRepository<Organization,Long> {
    @Query("SELECT new com.nilmani.onetooneunidirectional.dto.OrgAddressDto(o.id, o.name, a.building, a.city) FROM Organization o JOIN o.address a")
    fun findSomeRelationalFeatures(): List<OrgAddressDto>
}

JPQL通过JOIN o.address直接关联Address实体，JPA会自动根据@OneToOne注解的配置生成关联外键的匹配条件，不需要手动编写。

方案2：使用原生SQL

如果你要沿用在SQL编辑器中调试好的原生语句，只需要添加nativeQuery=true参数，同时语句里使用数据库实际的表名和外键字段：

interface OrganizationRepository : JpaRepository<Organization,Long> {
    @Query(value = "SELECT o.id, o.name, a.building, a.city FROM organization o INNER JOIN address a ON o.address_id = a.id", nativeQuery = true)
    fun findSomeRelationalFeatures(): List<Array<Any>>
    // 也可以直接用方案1的DTO接收，Spring Data JPA会自动做字段映射，不需要写构造函数
}

额外注意事项