Python sqlite3 事务模式下为什么 execute 后没有自动提交

在 Python 的 sqlite3 里，execute() 负责执行 SQL，commit() 负责结束当前事务并保存变更。默认连接仍采用兼容旧版本的事务控制方式：INSERT、UPDATE、DELETE 等写操作可能打开一个隐式事务，语句本身返回成功，也不表示新连接已经能看到这些数据。

排查“execute 后数据没保存”时，先确认写操作是否执行成功，再看连接是否处于事务中，最后在正确的边界调用 con.commit()；如果代码选择了自动提交模式，就不要再把默认模式的行为套进来。

为什么 execute 成功后仍然没有提交

事务把多条 SQL 组合成一个原子单元。execute() 把语句交给 SQLite 执行，SQLite 可以先把修改放在当前事务里，等待调用方决定提交还是撤销。这样做的好处是，更新订单和写入日志可以一起成功；如果第二步失败，前一步也能回滚。

下面这个例子中，第一条连接里的查询能看到自己的未提交修改，但关闭连接前没有提交，重新打开连接时就可能看不到这条记录：

import sqlite3

con = sqlite3.connect("demo.db")
try:
    # 写入语句只改变当前事务，成功返回不等于已落盘
    con.execute("INSERT INTO notes(body) VALUES (?)", ("待提交内容",))
    # 在业务操作全部成功后，明确提交这一组修改
    con.commit()
except Exception:
    # 任一步失败都撤销当前事务，避免留下半组数据
    con.rollback()
    raise
finally:
    # 提交或回滚之后再释放连接
    con.close()

用连接状态确认当前事务边界

不要只根据“没有抛异常”判断是否提交。连接对象的 in_transaction 可以帮助排查当前是否存在未提交事务；它适合做诊断，不应该替代业务代码中的明确提交。

import sqlite3

con = sqlite3.connect(":memory:")
con.execute("CREATE TABLE notes(id INTEGER PRIMARY KEY, body TEXT)")
print(con.in_transaction)  # 建表不作为本例的写事务判断依据

con.execute("INSERT INTO notes(body) VALUES (?)", ("先放入事务",))
print(con.in_transaction)  # 默认模式下通常为 True

con.commit()               # 明确结束事务
print(con.in_transaction)  # 提交后回到无待处理事务
con.close()

实际项目里还要看 SQL 类型和连接配置。SELECT 主要读取数据，不应被当成“提交触发器”；executemany() 同样只是批量执行写入，仍需按照当前事务模式决定何时提交。

默认模式、隔离级别和 autocommit 有什么区别

autocommit 参数从 Python 3.12 开始提供。为了兼容不同 Python 版本，不要只凭网上示例复制参数：老项目可以继续使用 isolation_level，新项目则应明确写出希望采用的事务语义，并在启动时记录 Python 版本。

用 with con 处理成功与异常

当一组写操作应该“要么全部成功、要么全部撤销”时，可以使用连接上下文管理器。离开 with 代码块时，正常退出会提交，异常退出会回滚；但它不会自动关闭连接，所以长期程序仍要显式调用 close()。

import sqlite3

con = sqlite3.connect("demo.db")
try:
    with con:
        # 同一个上下文中的两次写入作为一组事务处理
        con.execute("INSERT INTO notes(body) VALUES (?)", ("正文",))
        con.execute("INSERT INTO notes(body) VALUES (?)", ("索引记录",))
    # 正常离开 with 后才认为这一组操作已提交
finally:
    # with 不负责关闭连接，资源生命周期仍由调用方管理
    con.close()

如果写入函数内部已经提交，而外层还想统一回滚，就会破坏事务边界。更稳妥的做法是由一层代码拥有提交权：底层函数只执行 SQL，业务服务层决定整组操作何时提交。

常见问题

为什么程序结束后数据反而消失了？

最常见原因是写入后没有 commit()，连接关闭时待提交事务被回滚或没有被持久化。把提交放在业务成功边界，而不是随意放在每条 SQL 后。

commit() 调用多次会报错吗？

通常不会；没有待提交事务时，提交调用没有需要保存的修改。但这不代表可以忽略事务设计，提交位置仍决定多条操作是否保持原子性。

使用 with con 后还要 close 吗？

要。连接上下文管理器负责提交或回滚事务，不负责关闭连接。短脚本也建议在最后明确关闭，服务程序则应把连接生命周期交给连接管理代码。

参考：Python sqlite3 官方文档。