在 Go 应用中搭配 PostgreSQL 使用 UUID 作为主键时，无法依赖 LastInsertId()（因其仅适用于自增整数），应改用 RETURNING 子句配合 QueryRow().Scan() 安全、高效地获取插入后生成的 UUID。
在 go 应用中搭配 postgresql 使用 uuid 作为主键时，无法依赖 `lastinsertid()`（因其仅适用于自增整数），应改用 `returning` 子句配合 `queryrow().scan()` 安全、高效地获取插入后生成的 uuid。
PostgreSQL 的 RETURNING 子句是获取插入/更新/删除操作结果的理想机制，尤其适用于非自增主键（如 UUID）。Go 标准库 database/sql 的 Exec 方法不支持扫描返回值，因此不能直接调用 .Scan() —— 这正是问题中代码报错或行为未定义的根本原因。正确做法是使用 QueryRow，它专为单行查询设计，天然支持 RETURNING 并可安全绑定结果。
以下是一个完整、生产就绪的示例：
import (
"database/sql"
"github.com/lib/pq"
)
func createTodo(db *sql.DB, text string, listID string) (string, error) {
var todoID string
query := `INSERT INTO todos (text, list_id, todo_id)
VALUES ($1, $2, gen_random_uuid())
RETURNING todo_id`
err := db.QueryRow(query, text, listID).Scan(&todoID)
if err != nil {
return "", err // 注意：pq.ErrNoRows 表示无返回行（极罕见），其他错误需按需处理
}
return todoID, nil
}⚠️ 关键注意事项：
-
必须用
QueryRow，而非Exec：Exec返回sql.Result，其Scan()方法未定义（会 panic）；只有QueryRow和Query支持扫描。 -
确保
RETURNING字段存在且类型匹配：若todo_id是UUID类型（如UUID或TEXT），Go 变量应为string；若使用pgtype.UUID，则需对应类型及pgx驱动（本文基于lib/pq，故推荐string+ PostgreSQL 原生UUID列 +gen_random_uuid()函数）。 -
驱动兼容性：
lib/pq已归档，建议新项目迁移到pgx（性能更优、原生 UUID 支持更好），但RETURNING + QueryRow模式在两者中完全一致。 - 事务安全：该操作天然属于当前事务上下文，无需额外封装，适合嵌入复杂业务逻辑。
总结：放弃 LastInsertId()，拥抱 RETURNING —— 它不仅是 PostgreSQL 的强大特性，更是 Go 操作 UUID 主键表的标准实践。简洁、可靠、符合 SQL 规范，且无需额外查询或应用层生成 ID 冗余校验。
