一、错误现象与根本原因
当使用Python的sqlite3库执行数据库操作时，开发者经常会遇到如下错误：
sqlite3.OperationalError: database is locked这个错误表明SQLite数据库处于锁定状态，通常发生在以下场景：
- 多个数据库连接同时尝试写入操作
- 长时间运行的事务未提交
- 应用程序未正确关闭游标对象
- 使用了不恰当的并发控制策略
二、7种解决方案深度解析
1. 增加超时参数
在建立数据库连接时设置timeout参数：
conn = sqlite3.connect('database.db', timeout=30)这个参数指定了等待锁释放的最长时间（秒），默认值为5秒。
2. 使用WAL模式（Write-Ahead Logging）
启用WAL日志模式可以显著改善并发性能：
conn.execute('PRAGMA journal_mode=WAL')WAL模式允许读操作和写操作同时进行，减少了锁冲突。
3. 确保及时提交事务
典型错误示例：
# 错误示范
conn = sqlite3.connect('db.sqlite3')
cursor = conn.cursor()
cursor.execute("INSERT INTO users VALUES (...)")
# 忘记commit导致锁保持正确的做法是使用上下文管理器或显式提交：
with conn: # 自动提交
conn.execute("INSERT...")
# 或
conn.commit()4. 优化连接管理
使用连接池模式管理数据库连接：
import sqlite3
from contextlib import contextmanager
@contextmanager
def get_connection():
conn = sqlite3.connect('db.sqlite3', timeout=10)
try:
yield conn
finally:
conn.close()5. 检查外键约束
禁用外键检查可以临时解决锁问题：
conn.execute('PRAGMA foreign_keys=OFF')6. 调整同步设置
降低同步级别（风险与性能的权衡）：
conn.execute('PRAGMA synchronous=NORMAL')7. 检查文件权限
确保数据库文件有正确的读写权限：
chmod 664 database.db三、高级预防措施
对于高并发场景，建议：
- 使用SQLite3的
isolation_level参数 - 实现重试机制处理临时锁
- 考虑升级到PostgreSQL等更强大的数据库
- 定期执行
VACUUM命令维护数据库
四、性能测试数据
| 方案 | 并发能力 | 数据安全 |
|---|---|---|
| 默认配置 | 低 | 高 |
| WAL模式 | 高 | 中 |
| synchronous=OFF | 最高 | 低 |