能否为MyBatis Mapper配置可动态调整的查询超时时间？

在MyBatis中，直接在Mapper XML里通过#{timeout}动态绑定查询超时时间是完全可行的，不需要手动调用JDBC PreparedStatement.setQueryTimeout()方法。

具体实现方式 #

• 在XML映射文件的查询节点中，直接将timeout属性绑定到动态参数：

<select id="queryData" resultType="com.example.Data" timeout="#{timeout}">
    SELECT * FROM table WHERE id = #{id}
</select>

MyBatis会自动将传入的timeout参数值（单位为秒，需为int类型）传递给JDBC PreparedStatement，调用其setQueryTimeout()方法完成超时设置。

注意事项 #

• 参数类型必须为合法整数：JDBC的setQueryTimeout()仅接受int类型参数（秒数），如果传入null或非整数值，会触发参数绑定异常，建议在业务层提前校验参数，或设置默认值（比如#{timeout,defaultValue="30"}）。
• 注解式Mapper的局限性：如果使用@Select等注解定义查询，@Options(timeout = ...)属性只能接受常量值，无法直接绑定动态参数。这种场景下，可通过自定义MyBatis拦截器（Interceptor），在StatementHandler的执行阶段动态设置超时时间。

替代方案：自定义拦截器 #

如果需要全局或更灵活的超时控制，可编写拦截器拦截SQL执行过程，动态设置超时：

@Intercepts({@Signature(type = StatementHandler.class, method = "prepare", args = {Connection.class, Integer.class})})
public class TimeoutInterceptor implements Interceptor {
    @Override
    public Object intercept(Invocation invocation) throws Throwable {
        StatementHandler statementHandler = (StatementHandler) invocation.getTarget();
        MappedStatement mappedStatement = statementHandler.getMappedStatement();
        // 从MappedStatement的参数或自定义注解中获取超时值
        Integer timeout = getDynamicTimeout(mappedStatement);
        if (timeout != null) {
            Statement statement = (Statement) invocation.proceed();
            statement.setQueryTimeout(timeout);
            return statement;
        }
        return invocation.proceed();
    }
    // 实现获取动态超时值的逻辑
    private Integer getDynamicTimeout(MappedStatement mappedStatement) {
        // 根据业务需求从参数、配置等获取超时值
        return null;
    }
}

内容的提问来源于stack exchange，提问作者Ondřej Mazanec