SQLITE_BUSY错误排查：Sequelize事务中Quiz.update报错

报错原因 #

1. Sequelize事务参数传递错误：代码中多个Sequelize方法的事务参数位置写错，导致部分操作脱离事务范围，独立持有数据库锁，和后续事务内的Quiz.update产生冲突：
   • Quiz.findOne、deleteActions中的destroy方法都把transaction作为第二个参数传递，但Sequelize的查询/写操作只接受单个options对象，事务配置应该和where等参数放在同一个对象里。这会导致这些操作不受事务管控，单独占用数据库写锁，后续事务内的Quiz.update请求锁时就会触发SQLITE_BUSY。
2. SQLite本身的单写限制：SQLite是文件型数据库，同一时间仅支持一个写操作。如果有其他未关闭的数据库连接（比如其他请求、外部进程）在执行写操作，也会导致当前请求的事务无法获取锁。

可行解决办法 #

1. 修正事务参数传递（最关键） #

把所有操作的transaction参数移到正确的options对象中：

• 修正Quiz.findOne写法：

const previousQuiz = await Quiz.findOne({ 
  where: { quiz_id: quiz.quiz_id }, 
  transaction // 放到第一个配置对象内
});

• 修正deleteActions中的destroy操作（以MultipleChoice为例）：

"Multiple Choice": async (questions_id, transaction) => {
  await MultipleChoice.destroy({
    where: {
      question_id: {
        [Op.or]: questions_id
      }
    },
    transaction // 移到第一个options对象内
  });
}

其他deleteActions中的destroy操作同理修改。

2. 优化SQLite连接配置 #

在Sequelize初始化时，添加针对SQLite的锁等待和连接池配置：

const sequelize = new Sequelize({
  dialect: 'sqlite',
  storage: './database.sqlite',
  pool: {
    max: 1, // SQLite不支持多写连接，限制连接池最大数为1
    min: 0,
    idle: 10000
  },
  dialectOptions: {
    busyTimeout: 5000 // 等待锁释放的超时时间（毫秒），避免立即报错
  }
});

3. 检查外部锁占用 #

确认没有其他进程、脚本或请求长时间持有数据库写锁，比如是否有未关闭的调试连接、定时任务在执行写操作。

4. 确保事务流程闭环 #

检查代码中所有异步操作都包裹在try块内，确保异常时事务能正确回滚，避免残留锁。你的代码已经做了回滚逻辑，可额外确认createImage等非数据库操作不会阻塞事务流程。

内容的提问来源于stack exchange，提问作者Brian Serrano