在Spring中基于JDBC进行数据访问时如何控制超时

超时分类

超时根据作用域可做如下层级划分：

Transaction Timeout > Statement Timeout > JDBC Driver Socket Timeout

Transaction Timeout指一组SQL操作执行时应在设定的时间内完成(提交或回滚)，否则将引发超时。它的值应大于 N(语句数) * Statement Timeout

Statement Timeout指完成单条SQL语句执行的最大允许时间。它的值应小于JDBC Driver Socket Timeout的值，因为后者会被先检查。

最底层的JDBC Driver Socket Timeout指的是通过socket进行连接时的超时或者进行读写操作时的阻塞超时，如果不设置将使用OS层的Socket Timeout值。

超时设置

大部分场景中，应用主要关心Transaction Timeout的设置，除非Transaction中总是只有单条Statement。超时的具体设置依赖于使用的数据访问框架或者JDBC Driver。如果使用Spring作为基础框架，可以通过为transactionManager的defaultTimeout属性来设置全局的Transaction Timeout，或者在声明式事务(tx:attributes)的配置中为特定的或所有的方法指定timeout属性的值，还可以在注解式事务@Transactional标记中通过timeout参数来设置。

注意：

1.“Spring事务超时 = 事务开始时到最后一个Statement创建时时间 + 最后一个Statement的执行时超时时间（即其queryTimeout）。”(3)

2. 如果选择JpaTransactionManager作为事务管理器，需要Spring版本在3.0.0之上才能使timeout设置正常工作；

3. 如果选择DataSourceTransactionManager，事务内所有的sql操作必须通过JdbcTemplate执行才能使timeout设置正常工作，通过其他orm(如myBatis)执行的sql操作将无法应用超时设置。这种模式下需要按照具体orm框架的要求配置超时(例如myBatis的defaultStatementTimeout 4)

 

在某些场景中，确实存在混用两种数据访问框架的情况(姑且不讨论这种情况是否合理)。例如在同一事务中混用JdbcTemplate和MyBatis，在这种场景中，为@Transactional或tx:attributes设置的timeout将不会对非JdbcTemplate部分的操作生效，因此实际上已无法控制这个事务的超时。此时，有一种“变通”的方式能够使两种数据访问框架能够“共享”超时设置，那就是设置JDBC Driver Socket阻塞超时。如果使用的是Oracle数据库，并且数据源使用的是DBCP的BasicDataSource，可以在其connectionProperties属性中设置此值，例如：

 

<bean id="dataSource" class="org.apache.commons.dbcp.BasicDataSource" destroy-method="close">
        <!-- 设置毫秒单位的阻塞超时 -->
        <property name="connectionProperties" value="oracle.net.READ_TIMEOUT=1000"/>  

        <!-- 其他属性设置... -->
</bean>

如果同时有多个属性要设置，在value中通过分号分隔。其他数据库的设置方式参见资料3。

 

超时捕获

在Transaction timeout设置生效的情况下，发生超时后，框架将主动回滚当前事务并抛出UncategorizedSQLException。这是一个RuntimeException的子类，通过其getSql()或getMessage()方法可以得知引发超时的sql语句。

在使用JDBC Driver Socket阻塞超设置时，发生超时后，当前连接将被driver关闭，事务中正在执行的操作，不论是通过JdbcTemplate还是其他ORM框架执行的，都将引发SQLException(异常信息为：关闭的连接)，这个异常将被上层的TransactionInterceptor捕获并被重新包装成一个UncategorizedSQLException的实例，随后回滚事务，但由于连接已关闭，因此又会引发回滚异常，所以会看到

“TransactionInterceptor.completeTransactionAfterThrowing (TransactionAspectSupport.java:414)

Application exception overridden by rollback exception ”

最终，会向调用者抛出一个TransactionSystemException的实例，通过其getApplicationException()方法可以获得被覆盖前的那个UncategorizedSQLException的实例。

 

参考资料

1. Understanding JDBC Internals & Timeout Configuration

2. Spring transaction timeout doesn't work?

3. Spring事务超时时间可能存在的错误认识

4. Using Spring 3 with Mybatis 3 Tutorial – part 1