如何将Java数组数据传入PostgreSQL查询（Spring Boot JPA场景）

第一步：接口层参数转换 #

GET请求中place=1,2,3格式的参数默认会被识别为逗号拼接的字符串，首先在Controller层将其转换为数值集合，不要直接传拼接字符串：

@GetMapping("/abc/V1/XYZ")
public ResponseEntity<?> getXyzList(
        @RequestParam Integer item,
        @RequestParam String place,
        @RequestParam Integer location
) {
    // 拆分逗号分隔的字符串，转换为Integer类型列表
    List<Integer> placeParam = Arrays.stream(place.split(","))
            .map(String::trim)
            .map(Integer::parseInt)
            .toList();
    return ResponseEntity.ok(tableNameService.queryList(item, placeParam, location));
}

第二步：Repository层实现多值匹配 #

根据编码习惯选任意一种写法即可，JPA和PostgreSQL驱动会自动完成集合参数的类型适配，不需要手动拼接SQL。

方案1：JPA派生查询（无手写SQL，零适配成本） #

直接按照JPA方法名规则定义接口，框架会自动生成IN条件的查询语句：

public interface TableNameRepository extends JpaRepository<TableName, Long> {
    // 方法名中的In对应SQL的IN逻辑，直接传入集合参数即可
    List<TableName> findByItemAndPlaceInAndLocation(Integer item, List<Integer> placeList, Integer location);
}

方案2：自定义查询语句（适配手写SQL的场景） #

如果需要自己控制SQL逻辑，注意多值匹配要用IN关键字，参数直接绑定集合类型即可，禁止手动拼接SQL字符串避免注入风险：

JPQL写法（跨数据库兼容）

@Query("SELECT t FROM TableName t WHERE t.item = :item AND t.place IN :placeList AND t.location = :location")
List<TableName> customQuery(
        @Param("item") Integer item,
        @Param("placeList") List<Integer> placeList,
        @Param("location") Integer location
);

PostgreSQL原生SQL写法

@Query(
        value = "SELECT * FROM tablename WHERE item = :item AND place IN :placeList AND location = :location",
        nativeQuery = true
)
List<TableName> customNativeQuery(
        @Param("item") Integer item,
        @Param("placeList") List<Integer> placeList,
        @Param("location") Integer location
);

常见避坑点 #

• 不要直接把逗号拼接的字符串传给IN条件，会被识别为单个字符串值，无法匹配多值
• 如果place字段是PostgreSQL的数组类型（如int[]），而非单数值字段，把条件替换为place = ANY(:placeList)即可
• 不要在Java层手动拼接参数到SQL字符串中，会引发SQL注入漏洞，JPA的参数绑定机制会自动处理PostgreSQL的集合类型传参适配

内容的提问来源于stack exchange，提问作者kiran chand kothuru