JavaScript forEach插入SQLite3数据顺序错乱问题原因与解决

你的猜测完全正确，问题核心来自两点：

1. Node.js 环境下 sqlite3 包的db.run()方法是异步非阻塞的：调用该方法后不会等待SQL执行完成，会直接把操作丢进事件队列，继续执行后续代码，等SQL实际执行完才会触发传入的回调函数。
2. forEach是同步遍历方法，遍历过程中不会等待异步操作执行完成：你在forEach循环里连续调用db.run()时，多个插入请求几乎是同时被发起的，最终哪个插入操作先执行完成、先抢占到自增id写入磁盘，由事件循环的调度顺序决定，和你遍历数组的顺序没有必然关系，因此最终记录对应的自增id顺序和预期不符。

额外补充：即使写入顺序符合预期，执行SELECT查询时如果不添加ORDER BY子句，SQLite 本身也不保证返回结果的顺序，不要依赖数据库的默认存储顺序获取有序结果。

根据你的场景可以选择两种实现方式，都能保证插入顺序和数组遍历顺序一致：

方案1：串行逐行插入（逻辑简单，适合小数据量场景） #

把回调风格的db.run包装为Promise，使用for...of循环配合async/await，等上一条插入完全执行完成后，再发起下一条插入请求：

const comments = [
  {post_id: 1, comment: "lorem ipsum comment 1", comment_author: "user 1"},
  {post_id: 2, comment: "lorem ipsum comment 2", comment_author: "user 1"},
]

// 包装为Promise版本的执行方法
const run = (sql, params) => {
  return new Promise((resolve, reject) => {
    db.run(sql, params, function (err) {
      if (err) return reject(err)
      resolve(this)
    })
  })
}

// 串行执行插入
const insertData = async () => {
  const insertSql = `INSERT INTO comments(post_id, comment, comment_author) VALUES (?,?,?)`
  for (const item of comments) {
    try {
      await run(insertSql, [item.post_id, item.comment, item.comment_author])
    } catch (err) {
      console.log(err.message)
    }
  }
}

insertData()

插入完成后执行SELECT * FROM comments ORDER BY id ASC就能得到你预期的有序结果。

方案2：事务批量插入（性能更高，适合中大型数据量场景） #

利用sqlite3自带的db.serialize()方法保证操作串行执行，配合事务批量提交，既保证插入顺序，又能大幅减少磁盘IO开销，提升导入速度：

const comments = [
  {post_id: 1, comment: "lorem ipsum comment 1", comment_author: "user 1"},
  {post_id: 2, comment: "lorem ipsum comment 2", comment_author: "user 1"},
]

const batchInsert = () => {
  return new Promise((resolve, reject) => {
    db.serialize(() => {
      db.run('BEGIN TRANSACTION')
      const stmt = db.prepare(`INSERT INTO comments(post_id, comment, comment_author) VALUES (?,?,?)`)
      
      comments.forEach(item => {
        stmt.run([item.post_id, item.comment, item.comment_author], err => {
          if (err) console.log(err.message)
        })
      })

      stmt.finalize(err => {
        if (err) {
          db.run('ROLLBACK', () => reject(err))
          return
        }
        db.run('COMMIT', resolve)
      })
    })
  })
}

batchInsert()

内容的提问来源于stack exchange，提问作者Maik Lowrey