JPA 中如何正确传递包含多个字段的参数列表进行批量查询-java教程-PHP中文网

JPA 中如何正确传递包含多个字段的参数列表进行批量查询

本文讲解在 Spring Data JPA 中使用原生 SQL 查询时，如何将自定义对象列表（如含 id、firstName、lastName 的搜索参数）安全传入 @Query，解决因 Kotlin 注解位置错误导致的类型推断失败问题。

本文讲解在 spring data jpa 中使用原生 sql 查询时，如何将自定义对象列表（如含 id、firstname、lastname 的搜索参数）安全传入 `@query`，解决因 kotlin 注解位置错误导致的类型推断失败问题。

在使用 Spring Data JPA 进行批量条件查询时，一个常见需求是：不再对每个参数组合循环调用单条查询，而是将一组结构化搜索条件一次性传入数据库，由一条 SQL 返回匹配的所有实体。但直接将 Kotlin 数据类列表作为 @Param 参数传入原生查询（nativeQuery = true）时，常会遇到类似 Could not determine a type for class: ... 的错误——这并非 SQL 逻辑问题，而是 Kotlin 注解作用目标（use-site target）未显式指定 所致。

? 根本原因分析

JPA（尤其是 Hibernate）在解析 @Param("personSearchParams") 对应的 Kotlin 类型时，需通过反射读取其字段上的约束注解（如 @NotBlank）。Kotlin 默认将 @NotBlank 视为构造函数参数注解，而非字段（field）注解；而 Hibernate 实际检查的是 JVM 字节码中的字段元数据。若注解未落在字段上，框架无法识别校验规则，进而无法确定该类是否可安全用于参数绑定，最终抛出类型推断异常。

✅ 正确实现方式

1. 修正数据类：明确注解作用目标

data class PersonSearchParam(
    @field:NotBlank(message = "id must not be blank.")
    var id: String,

    @field:NotBlank(message = "firstName must not be blank.")
    var firstName: String,

    @field:NotBlank(message = "lastName must not be blank.")
    var lastName: String
)

⚠️ 注意：类名首字母大写（PersonSearchParam），并使用 @field: 显式指定注解应用于字段（field），这是 Kotlin 的关键语法。

2. 重构查询：避免跨字段 IN 匹配逻辑错误

您原始 SQL 存在语义缺陷：p.id IN :personSearchParams 要求 personSearchParams 是 String 列表，但实际传入的是 PersonSearchParam 对象列表，且 firstName IN :... 等子句无法直接展开对象属性。正确的做法是使用 JOIN 或 UNNEST（PostgreSQL）/ VALUES（MySQL 8.0.19+）模拟参数表。推荐更健壮、数据库无关的方案：

✅ 推荐方案：使用 JPQL + IN 分别处理各字段（适用于简单等值匹配）

@Query("SELECT DISTINCT p FROM Person p " +
       "WHERE p.id IN :ids " +
       "AND p.firstName IN :firstNames " +
       "AND p.lastName IN :lastNames")
fun findByIdAndFirstNameAndLastName(
    @Param("ids") ids: List<string>,
    @Param("firstNames") firstNames: List<string>,
    @Param("lastNames") lastNames: List<string>
): List<person></person></string></string></string>

调用时提取字段：

val params = listOf(
    PersonSearchParam("1", "John", "Doe"),
    PersonSearchParam("2", "Jane", "Smith")
)
repository.findByIdAndFirstNameAndLastName(
    ids = params.map { it.id },
    firstNames = params.map { it.firstName },
    lastNames = params.map { it.lastName }
)

⚠️ 若坚持原生查询 + 对象列表（高级场景）

需数据库支持行构造器（如 PostgreSQL）：

@Query(nativeQuery = true, value = """
    SELECT DISTINCT p.* FROM PEOPLE p
    INNER JOIN (
        VALUES 
        (:#{#personSearchParams[0].id}, :#{#personSearchParams[0].firstName}, :#{#personSearchParams[0].lastName}),
        (:#{#personSearchParams[1].id}, :#{#personSearchParams[1].firstName}, :#{#personSearchParams[1].lastName})
    ) AS v(id, first_name, last_name) 
    ON p.id = v.id AND p.first_name = v.first_name AND p.last_name = v.last_name
""")
fun findByCompositeParams(@Param("personSearchParams") personSearchParams: List<personsearchparam>): List<person></person></personsearchparam>