【问题记录5】， 记录一个困扰半天的问题， @Options(timeout = 1) 不生效问题

url连接串上配置， &sessionVariables=ob_trx_timeout=300000000;ob_query_timeout=60000000
@Options(timeout = 1)
Page findDataList(Page page,@Param(“sql”) String sql); 为啥注解不生效， 没查询超时， sql执行时间是10s

如果 @Options(timeout = 1) 注解没有生效，可能由多种原因导致。以下是一些排查步骤：

1. 检查 MyBatis 版本

确保你使用的 MyBatis 版本支持 @Options 注解的 timeout 属性。较新的版本通常支持此功能。

2. 检查注解是否正确应用

确保 @Options(timeout = 1) 注解正确地应用在了 Mapper 接口的方法上。

3. 检查数据库连接和驱动

确保数据库连接和驱动程序没有问题，有些数据库驱动可能对超时设置支持不好。

4. 查看日志

开启 MyBatis 的日志功能，查看 SQL 语句的执行情况和时间，确认是否执行了超时的 SQL 语句。

5. 检查其他超时设置

如果有其他地方设置了超时时间（如连接串、会话级别等），可能会相互影响，注意排查。

6. 测试单个查询

创建一个简单的测试用例，执行一个故意超时的查询，验证 @Options(timeout = ...) 是否生效。

7. 确保 SQL 执行时间确实超过超时时间

如果 SQL 语句执行时间短于超时时间，则不会触发超时机制。

示例代码

@Options(timeout = 1)
Page<MyData> findDataList(Page<MyData> page, @Param("sql") String sql);

注意事项

• 单位是秒：@Options 注解中的 timeout 属性单位是秒，1 表示 1 秒。
• 数据库支持：确保使用的数据库支持查询超时的设置。
• 其他超时设置：如果有其他地方设置了超时时间（如连接串、会话级别等），可能会相互影响，注意排查。

如果经过上述排查仍未解决问题，可以尝试在具体的业务场景中手动设置超时时间：

try (SqlSession session = sqlSessionFactory.openSession()) {
    session.getConfiguration().setDefaultStatementTimeout(1);
    GzSqlConfigMapper mapper = session.getMapper(GzSqlConfigMapper.class);
    Page<MyData> result = mapper.findDataList(page, sql);
}

总结

如果 @Options(timeout = 1) 注解没有生效，可能是由于 MyBatis 版本问题、注解未正确应用、数据库驱动问题或其他超时设置相互影响。通过逐步排查，应该可以找到问题所在并解决。

根据提示把url连接串换成就生效了

driver-class-name: com.mysql.cj.jdbc.Driver
url: jdbc:mysql://x.x.x.x:3306/dev?useUnicode=true&characterEncoding=utf-8&allowMultiQueries=true&useSSL=false&allowPublicKeyRetrieval=true&serverTimezone=Asia/Shanghai&sessionVariables=ob_trx_timeout=300000000;ob_query_timeout=60000000

原先用的驱动是 # driver-class-name: com.alipay.oceanbase.jdbc.Driver
连接串是 url: jdbc:oceanbase:loadbalance://x.x.x.x:3306/dev?useUnicode=true&characterEncoding=utf-8&allowMultiQueries=true&useSSL=false&allowPublicKeyRetrieval=true&serverTimezone=Asia/Shanghai&sessionVariables=ob_trx_timeout=300000000;ob_query_timeout=60000000

以下是关于 global ob_query_timeout、URL 连接串上的 ob_query_timeout、MyBatis-Plus 的 default-statement-timeout 以及 @Options(timeout = 1) 这四种配置的区别：

配置方式	作用范围	生效时机	默认值	单位	说明
global ob_query_timeout	全局	数据库服务器层面，对所有会话生效	10000000（10秒）	微秒	通过 SET GLOBAL ob_query_timeout = 300000000; 设置，适用于 OceanBase 数据库，是数据库层面的全局超时时间设置。OBProxy 和 OBServer 的全局参数设置会持久化存储在 oceanbase.__all_sys_variable 系统表中，集群重启后仍有效。
URL 连接串上的ob_query_timeout	会话级别	连接建立时	无	微秒	在 JDBC 连接串中通过 sessionVariables=ob_query_timeout=60000000 设置，仅对当前会话生效。
MyBatis-Plus 的default-statement-timeout	全局	应用启动时	无	秒	在 MyBatis-Plus 的配置文件中设置，如 mybatis-plus.configuration.default-statement-timeout=30，适用于所有 SQL 查询。
@Options(timeout = 1)	单个方法级别	方法调用时	无	秒	在 MyBatis 的 Mapper 接口中，使用 @Options(timeout = 1) 注解为特定的 SQL 查询设置超时时间，仅对当前方法生效。

优先级说明：

• @Options(timeout = 1) 注解的优先级最高，适用于特定的 SQL 查询方法。
• URL 连接串上的 ob_query_timeout 优先级次之，适用于当前会话中的所有查询。
• MyBatis-Plus 的 default-statement-timeout 配置的优先级低于注解和连接串设置，适用于全局所有查询。
• global ob_query_timeout 的优先级最低，是数据库层面的兜底设置。

注意事项：

• 单位换算：ob_query_timeout 和 global ob_query_timeout 的单位是微秒，而 MyBatis-Plus 的 default-statement-timeout 和 @Options 注解的单位是秒。设置时需注意单位换算。
• 生效范围：global ob_query_timeout 是数据库服务器的全局设置，适用于所有会话；URL 连接串上的 ob_query_timeout 仅对当前会话生效；MyBatis-Plus 的 default-statement-timeout 是应用层面的全局设置；@Options 注解适用于单个方法级别的查询。
• OBProxy 影响：如果使用了 OBProxy，还需考虑其超时设置可能对实际生效的超时时间产生影响。