调用 Connection.setAutoCommit(false) 是开启 JDBC 手动事务的必要前提，它关闭自动提交模式，使后续 DML 操作纳入同一事务，由 commit() 或 rollback() 显式控制，确保多步操作的原子性。
Java 中使用 Connection.setAutoCommit(false) 是开启 JDBC 手动事务管理最基础、最直接的方式。它让数据库连接脱离自动提交模式，后续的 SQL 操作将被纳入同一个事务，直到显式调用 commit() 或 rollback()。
为什么需要 setAutoCommit(false)
默认情况下，JDBC 连接处于自动提交（auto-commit）模式：每执行一条 DML（如 INSERT/UPDATE/DELETE）语句，数据库立即持久化并隐式提交。这无法满足“多步操作要么全成功、要么全失败”的业务需求（例如转账：扣款 + 入账必须原子性）。调用 setAutoCommit(false) 后，所有 SQL 都暂存在事务上下文中，由应用控制最终是否生效。
基本使用步骤
手动事务的核心流程固定，需严格遵循顺序，避免资源泄漏或数据不一致：
- 从数据源获取
Connection，立即调用conn.setAutoCommit(false) - 执行一个或多个 SQL 操作（使用
Statement或PreparedStatement） - 若全部成功，调用
conn.commit()提交事务 - 若任一环节出错（异常、校验失败等），调用
conn.rollback()回滚所有变更 - 无论成功或失败，都必须在
finally块中恢复 auto-commit 状态（可选但推荐）并关闭连接
典型代码示例（无框架裸 JDBC）
以下是一个安全的转账操作片段：
立即学习“Java免费学习笔记（深入）”；
Connection conn = null;
try {
conn = dataSource.getConnection();
conn.setAutoCommit(false); // 关键：关闭自动提交
<pre class="brush:php;toolbar:false;">// 扣款
String deductSql = "UPDATE account SET balance = balance - ? WHERE id = ?";
try (PreparedStatement ps1 = conn.prepareStatement(deductSql)) {
ps1.setBigDecimal(1, amount);
ps1.setLong(2, fromId);
if (ps1.executeUpdate() != 1) throw new RuntimeException("扣款失败");
}
// 入账
String creditSql = "UPDATE account SET balance = balance + ? WHERE id = ?";
try (PreparedStatement ps2 = conn.prepareStatement(creditSql)) {
ps2.setBigDecimal(1, amount);
ps2.setLong(2, toId);
if (ps2.executeUpdate() != 1) throw new RuntimeException("入账失败");
}
conn.commit(); // 全部成功才提交} catch (SQLException e) { if (conn != null) { try { conn.rollback(); // 出错就回滚 } catch (SQLException rollbackEx) { // 记录 rollback 失败日志 } } throw e; } finally { if (conn != null) { try { conn.setAutoCommit(true); // 恢复默认状态（便于连接池复用） conn.close(); } catch (SQLException e) { // 记录关闭异常 } } }
注意事项与常见陷阱
-
连接池场景下务必恢复 auto-commit：很多连接池（如 HikariCP、Druid）要求归还连接前 auto-commit 为
true，否则可能引发后续使用者拿到非预期状态的连接 - 不要在事务中混用不同 Connection：每个事务绑定唯一 Connection；跨连接的操作无法保证原子性
-
超时与长事务风险：长时间未 commit/rollback 会占用数据库锁和连接资源，建议设置合理的事务超时（如通过
conn.setTransactionIsolation()或连接池配置） - 只对 DML 生效：DDL（如 CREATE TABLE）语句在多数数据库中会隐式提交当前事务，导致提前结束
