Spring Boot JDBCClient查询PostgreSQL枚举类型IN子句的更优实现咨询

你当前手动拼接数组字面量的方式确实不够简洁，还存在潜在语法风险（比如枚举值含特殊字符时会出错）。针对PostgreSQL枚举类型的IN子句查询，这里提供两种更优雅的实现方式：

方式一：利用JdbcClient原生数组参数支持 #

PostgreSQL支持直接传递数组参数配合ANY()运算符，JdbcClient可以直接绑定枚举数组，无需手动拼接字符串：

private final JdbcClient jdbcClient;

// 简化SQL，无需手动转换数组类型
String sql = """
        SELECT * 
        FROM configuration 
        WHERE status = ANY(?)
        """;

return jdbcClient.sql(sql)
        // 直接传递枚举数组，JdbcClient自动处理类型映射
        .param(request.configurationStatus().toArray(ConfigurationStatus[]::new))
        .query(this::parseConfiguration)
        .list();

注意事项 #

如果Spring无法自动识别PostgreSQL枚举类型，需要在JdbcClient构建时指定枚举的SQL类型：

@Bean
public JdbcClient jdbcClient(DataSource dataSource) {
    return JdbcClient.builder(dataSource)
            // 将自定义枚举映射为SQL的OTHER类型（对应PostgreSQL枚举）
            .sqlType(ConfigurationStatus.class, SqlType.OTHER)
            .build();
}

方式二：动态生成IN子句占位符 #

如果更习惯传统IN子句的写法，可以动态生成对应数量的占位符，直接绑定枚举列表：

private final JdbcClient jdbcClient;

List<ConfigurationStatus> statusList = request.configurationStatus();
// 根据列表长度生成占位符，比如[STATUS1, STATUS2]对应"?,?"
String placeholders = statusList.stream()
        .map(item -> "?")
        .collect(Collectors.joining(","));

String sql = String.format("""
        SELECT * 
        FROM configuration 
        WHERE status IN (%s)
        """, placeholders);

return jdbcClient.sql(sql)
        // 直接传入枚举列表，JdbcClient逐个绑定参数
        .params(statusList)
        .query(this::parseConfiguration)
        .list();

两种方案对比 #

• 数组参数方案：代码更简洁，适合枚举值数量较多的场景，PostgreSQL对数组查询的优化较好，避免生成大量占位符。
• 动态IN占位符方案：更符合常规SQL编写习惯，无需额外配置类型映射，适合枚举值数量较少的场景。

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