Spring Boot JPA复合主键批量更新出现类型匹配错误求助

问题背景 #

有一张以id和created_at为复合主键的events表，目标是通过批量匹配复合主键更新status字段。原生SQL语句如下：

update events set status = true where (id, created_at) in ((1, '2024-06-17 12:00:44.674394+01'), (id2, time2), (id3, time3)...);

使用Spring Boot JPA的原生查询实现时，传入List<Object[]>作为复合主键列表，触发错误：

[ERROR: operator does not exist: record = bytea Hint: No operator matches the given name and argument types. You might need to add explicit type casts. Position: 87] [n/a].

原因分析 #

JPA默认会将Object[]类型的参数序列化为bytea（二进制类型），而PostgreSQL无法将bytea转换为复合主键所需的record类型，导致运算符不匹配错误。

解决方案 #

方法1：使用PostgreSQL的UNNEST函数拆分数组 #

利用PostgreSQL的数组拆分函数UNNEST，将复合主键的两个字段分别拆分为独立数组传入，通过子查询匹配复合主键：

@Modifying
@Transactional
@Query(
    value = """
        UPDATE events e
        SET status = true
        WHERE (e.id, e.created_at) IN (
            SELECT unnest(:ids), unnest(:timestamps)
        )
        """,
    nativeQuery = true
)
int updateStatus(List<Long> ids, List<OffsetDateTime> timestamps);

注意事项：

• 确保ids和timestamps的长度完全一致，且位置一一对应（第N个id对应第N个时间戳）
• created_at的Java类型需与数据库字段匹配：若数据库是timestamptz类型，用OffsetDateTime；若为timestamp，用LocalDateTime
• 调用时直接传入两个有序列表即可，无需包装为Object[]

方法2：动态构造SQL（不推荐，需防注入） #

如果必须保留复合主键的列表形式，可以通过动态构造SQL的方式生成IN子句，但需严格过滤参数避免SQL注入：

@Modifying
@Transactional
@Query(
    value = """
        UPDATE events
        SET status = true
        WHERE (id, created_at) IN (:pkString)
        """,
    nativeQuery = true
)
int updateStatus(@Param("pkString") String pkString);

调用时手动拼接合法的复合主键字符串：

// 示例：生成"(1, '2024-06-17 12:00:44.674394+01'), (2, '2024-06-18 10:00:00+01')"
String pkString = pkList.stream()
    .map(arr -> String.format("(%d, '%s')", arr[0], arr[1]))
    .collect(Collectors.joining(", "));
repository.updateStatus(pkString);

此方法存在SQL注入风险，仅在参数完全可控时使用。

验证测试 #

调用方法1时，传入对应类型的有序列表，JPA会正确绑定数组参数，PostgreSQL通过UNNEST将数组拆分为行，匹配复合主键完成批量更新。

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