Spring Data @Query中PostgreSQL嵌套ARRAY类型适配问题

你的问题核心是参数传递时没有让JDBC正确识别PostgreSQL的二维数组类型：直接传"ARRAY[ARRAY[2,2],...]"这种字符串会被当成普通text值，而字段productArr是text[]（二维文本数组），所以类型不兼容。下面给两种直接可行的解决方案：

方案一：直接传递二维数组参数（推荐） #

Spring Data和PostgreSQL JDBC驱动支持直接绑定二维数组类型，不需要手动写ARRAY语法：

1. 修改仓库方法的参数类型为String[][]：

@Modifying
@Query(value = """
        UPDATE user
        SET productArr = :productArr WHERE id = :userId
        """, nativeQuery = true)
void updateProductArr (@Param("productArr") String[][] productArr, @Param("userId") Long userId);

2. 调用时直接传入Java二维数组：

String[][] productArr = {{"2","2"}, {"3","2"}, {"1","3"}};
userRepository.updateProductArr(productArr, 1L);

驱动会自动把Java二维数组转换成PostgreSQL的text[]类型，完美匹配字段类型。

方案二：用CAST转换字符串为数组 #

如果必须用字符串形式传递参数，需要使用PostgreSQL的数组文本格式（大括号包裹，而非ARRAY[]语法），再通过CAST转换类型：

1. 修改仓库方法的SQL，添加CAST转换：

@Modifying
@Query(value = """
        UPDATE user
        SET productArr = CAST(:productArr AS text[]) WHERE id = :userId
        """, nativeQuery = true)
void updateProductArr (@Param("productArr") String productArr, @Param("userId") Long userId);

2. 传入的字符串参数改为PostgreSQL数组的原生文本格式：

String productArr = "{{2,2},{3,2},{1,3}}";
userRepository.updateProductArr(productArr, 1L);

这里的{{2,2},{3,2},{1,3}}是PostgreSQL识别的二维数组文本，CAST会把它转换成text[]类型。

为什么之前的尝试没生效？ #

• 传String[]或List<String>是一维数组，和字段的二维数组text[]类型不匹配；
• 直接传"ARRAY[ARRAY[2,2],...]"会被JDBC当作普通字符串，不会被解析成PostgreSQL的数组表达式，所以类型错误。

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