SQLite 中使用 RETURNING 子句获取插入行 ID 的完整指南

sqlite 不支持 sql server 风格的 `output` 子句，但自 3.35.0 版本起原生支持标准 sql 的 `returning` 子句，可直接在 `insert` 语句后返回新插入行的指定字段（包括自增主键），无需额外查询。

SQLite 是轻量级嵌入式数据库，其语法与 PostgreSQL、SQL Server 等有明显差异。你遇到的 SQLITE_ERROR: near "OUTPUT": syntax error 错误，根本原因是 OUTPUT 是 SQL Server/T-SQL 特有语法，SQLite 完全不识别。正确替代方案是使用 SQLite 原生支持的 RETURNING 子句（自 SQLite 3.35.0 起正式引入）。

✅ 正确用法：RETURNING 替代 OUTPUT

将原代码中错误的 OUTPUT INSERTED.* 删除，并在 VALUES 后添加 RETURNING *：

INSERT INTO articles(
  creation_date, publish_date, last_modified_date,
  title, subtitle, article_text, likes, author_id, published
)
VALUES (
  CURRENT_TIMESTAMP, CURRENT_TIMESTAMP, CURRENT_TIMESTAMP,
  ?, ?, ?, ?, ?, ?
)
RETURNING *;

对应 Node.js（如使用 sqlite3 模块）调用示例：

趣问问AI

免费可用的国内版chat，AI写作和AI对话

下载

global.db.all(
  `INSERT INTO articles(
     creation_date, publish_date, last_modified_date,
     title, subtitle, article_text, likes, author_id, published
   )
   VALUES (CURRENT_TIMESTAMP, CURRENT_TIMESTAMP, CURRENT_TIMESTAMP, ?, ?, ?, ?, ?, ?)
   RETURNING rowid, id, title, created_at;`,
  newValues,
  function (err, rows) {
    if (err) {
      return next(err);
    }
    // rows 是一个包含返回字段的对象数组（即使只插一行，也是 [{...}]）
    res.json({ message: "Saved", newRow: rows[0] });
  }
);

? 注意：RETURNING 返回的是一个数组（即使仅插入单行），因此取结果需用 rows[0]。若只需主键（假设表有 INTEGER PRIMARY KEY 列，即 rowid 别名），可明确写 RETURNING rowid 或 RETURNING id，提升性能和可读性。

?️ 进阶优化：简化时间戳字段

若 creation_date、publish_date、last_modified_date 始终为当前时间，推荐在建表时设置默认值，避免每次 INSERT 重复写 CURRENT_TIMESTAMP：

CREATE TABLE articles (
  id INTEGER PRIMARY KEY AUTOINCREMENT,
  title TEXT NOT NULL,
  subtitle TEXT,
  article_text TEXT,
  likes INTEGER DEFAULT 0,
  author_id INTEGER,
  published BOOLEAN DEFAULT 0,
  creation_date TEXT DEFAULT CURRENT_TIMESTAMP,
  publish_date TEXT DEFAULT CURRENT_TIMESTAMP,
  last_modified_date TEXT DEFAULT CURRENT_TIMESTAMP
);

此时插入语句可大幅精简：

INSERT INTO articles(title, subtitle, article_text, likes, author_id, published)
VALUES (?, ?, ?, ?, ?, ?)
RETURNING id, title, creation_date;

⚠️ 注意事项

• ✅ RETURNING 仅适用于 SQLite ≥ 3.35.0（2021 年 3 月发布）。请运行 SELECT sqlite_version(); 确认版本。
• ❌ 不支持 INSERT ... SELECT ... RETURNING 中的 RETURNING（SQLite 当前限制），仅支持 INSERT ... VALUES ... RETURNING。
• ? RETURNING 后可指定具体列（如 RETURNING id, title），比 RETURNING * 更高效、更安全。
• ? 若需兼容旧版 SQLite（同一事务中执行以避免竞态。

✅ 总结

拥抱 RETURNING，告别冗余查询——这是现代 SQLite 应用提升健壮性与可维护性的关键一步。