如何为NamedParameterJdbcTemplate的每个查询设置不同超时时间？

我正在使用NamedParameterJdbcTemplate，现有三个方法逻辑基本一致，仅SQL查询不同，代码示例如下：

public open fun method1() : String {
    val sql = "select * from func1()"
    return namedParameterJdbcTemplate.queryForObject(sql, MapSqlParameterSource(), String::class.java)
}

public open fun method2() : String {
    val sql = "select * from func2()"
    return namedParameterJdbcTemplate.queryForObject(sql, MapSqlParameterSource(), String::class.java)
}

public open fun method3() : String {
    val sql = "select * from func3()"
    return namedParameterJdbcTemplate.queryForObject(sql, MapSqlParameterSource(), String::class.java)
}

我需要为每个方法的查询设置不同超时时间（比如method1设10秒，method2设5秒），但setQueryTimeout是为JdbcTemplate统一设置超时，所有查询共用该值。我有两种思路：

1. 为每个方法创建对应超时时间的独立JdbcTemplate；
2. 使用同一个JdbcTemplate，在每个方法中修改超时时间。
   不确定该选哪种，也想了解是否有其他可行方案。

不推荐的方案：动态修改同一个JdbcTemplate的超时 #

JdbcTemplate的queryTimeout是实例级变量，多线程环境下修改会导致并发问题——比如method1刚把超时设为10秒，method2立刻改成5秒，此时method1的查询可能会用5秒超时执行，完全不符合预期。除非你的应用是单线程场景，否则这个方案绝对要避免。

推荐方案1：创建独立的JdbcTemplate/NamedParameterJdbcTemplate实例 #

每个实例固定配置对应的超时时间，线程安全，逻辑清晰。

实现方式 #

在配置类中定义多个Bean，分别设置不同的queryTimeout：

@Configuration
class JdbcConfig {
    @Bean
    fun jdbcTemplate1(dataSource: DataSource): NamedParameterJdbcTemplate {
        val jdbcTemplate = JdbcTemplate(dataSource)
        jdbcTemplate.setQueryTimeout(10) // 10秒超时
        return NamedParameterJdbcTemplate(jdbcTemplate)
    }

    @Bean
    fun jdbcTemplate2(dataSource: DataSource): NamedParameterJdbcTemplate {
        val jdbcTemplate = JdbcTemplate(dataSource)
        jdbcTemplate.setQueryTimeout(5) // 5秒超时
        return NamedParameterJdbcTemplate(jdbcTemplate)
    }

    @Bean
    fun jdbcTemplate3(dataSource: DataSource): NamedParameterJdbcTemplate {
        val jdbcTemplate = JdbcTemplate(dataSource)
        jdbcTemplate.setQueryTimeout(3) // 自定义超时
        return NamedParameterJdbcTemplate(jdbcTemplate)
    }
}

然后在业务类中注入对应的实例：

@Service
class MyService(
    @Qualifier("jdbcTemplate1") private val jdbcTemplate1: NamedParameterJdbcTemplate,
    @Qualifier("jdbcTemplate2") private val jdbcTemplate2: NamedParameterJdbcTemplate,
    @Qualifier("jdbcTemplate3") private val jdbcTemplate3: NamedParameterJdbcTemplate
) {
    public open fun method1(): String {
        val sql = "select * from func1()"
        return jdbcTemplate1.queryForObject(sql, MapSqlParameterSource(), String::class.java)
    }

    public open fun method2(): String {
        val sql = "select * from func2()"
        return jdbcTemplate2.queryForObject(sql, MapSqlParameterSource(), String::class.java)
    }

    public open fun method3(): String {
        val sql = "select * from func3()"
        return jdbcTemplate3.queryForObject(sql, MapSqlParameterSource(), String::class.java)
    }
}

优点：线程安全，配置与业务逻辑分离，维护简单；缺点：如果需要大量不同超时的查询，会产生较多Bean，略显冗余。

推荐方案2：自定义PreparedStatement设置超时（灵活无冗余） #

不需要创建多个JdbcTemplate实例，而是在每个查询中直接为PreparedStatement设置超时，通过封装通用方法减少重复代码。

实现方式 #

封装一个通用执行方法，内部处理超时设置：

@Service
class MyService(private val namedParameterJdbcTemplate: NamedParameterJdbcTemplate) {
    private fun executeWithTimeout(sql: String, timeout: Int): String {
        // 使用PreparedStatementCreatorFactory处理参数和SQL，同时设置超时
        val factory = PreparedStatementCreatorFactory(sql)
        factory.queryTimeout = timeout
        val creator = factory.newPreparedStatementCreator(MapSqlParameterSource())
        
        return namedParameterJdbcTemplate.jdbcOperations.queryForObject(creator, String::class.java)
    }

    public open fun method1(): String {
        return executeWithTimeout("select * from func1()", 10)
    }

    public open fun method2(): String {
        return executeWithTimeout("select * from func2()", 5)
    }

    public open fun method3(): String {
        return executeWithTimeout("select * from func3()", 3)
    }
}

如果需要处理带参数的查询，只需要修改executeWithTimeout方法，传入SqlParameterSource即可：

private fun <T> executeWithTimeout(sql: String, params: SqlParameterSource, timeout: Int, resultType: Class<T>): T {
    val factory = PreparedStatementCreatorFactory(sql)
    factory.queryTimeout = timeout
    val creator = factory.newPreparedStatementCreator(params)
    
    return namedParameterJdbcTemplate.jdbcOperations.queryForObject(creator, resultType)
}

优点：无需多个JdbcTemplate实例，灵活支持任意超时设置，代码复用性高；缺点：需要手动处理PreparedStatement的创建，比直接用现成Bean多写一点代码。

方案选择建议 #

• 如果你的超时配置是固定的、数量不多（比如就这3个），优先用独立JdbcTemplate实例，配置简单，维护成本低；
• 如果需要支持大量不同超时的查询，或者超时时间需要动态调整，选自定义PreparedStatement设置超时的方案更灵活。

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