Oracle 中获取最后插入记录 ID 的完整 Go 实战指南

在 Go 应用中操作 Oracle 数据库时，一个非常典型的场景是：插入主表记录后，立刻拿到自动生成的主键（比如通过序列加触发器实现的），然后把这个 ID 作为外键插入到从表里。如果你是从 MySQL 或 SQL Server 转过来的，第一反应可能是去调 `LastInsertId()`。但抱歉，这条路在 Oracle 驱动里是走不通的。

那这个问题的解决办法，其实 Oracle 官方早就给了，就是 `RETURNING INTO` 子句。结合 Go 里的 `sqlx.QueryRow()`，可以在一次插入操作中，安全又高效地把新生成的主键直接拿回来。

正确的姿势：RETURNING ... INTO + sqlx.QueryRow

先假设你有这样一张表，主键通过序列和触发器自动生成：

CREATE TABLE t (
    x INT PRIMARY KEY,
    created_at DATE DEFAULT SYSDATE
);
CREATE SEQUENCE x_seq START WITH 1 INCREMENT BY 1;

CREATE OR REPLACE TRIGGER t_bi_trg
    BEFORE INSERT ON t FOR EACH ROW
BEGIN
    SELECT x_seq.NEXTVAL INTO :NEW.x FROM DUAL;
END;

在 Go 代码里，千万别再尝试 `r.LastInsertId()` 了。正确的做法是用 `sqlx.QueryRow()` 执行带 `RETURNING` 的插入语句：

package main

import (
    "fmt"
    "log"
    "github.com/jmoiron/sqlx"
    _ "github.com/mattn/go-oci8"
)

func main() {
    db, err := sqlx.Connect("oci8", "user/pass@localhost:49161/xe")
    if err != nil {
        log.Fatal("连接失败:", err)
    }
    defer db.Close()

    // 关键点：用 RETURNING 子句把刚插入的主键拿回来
    var insertedID int
    err = db.QueryRow(
        "INSERT INTO t (created_at) VALUES (SYSDATE) RETURNING x INTO ?",
        &insertedID,
    ).Err()
    if err != nil {
        log.Fatal("插入并获取 ID 失败:", err)
    }
    fmt.Printf("成功插入，生成主键 ID: %d\n", insertedID)

    // 现在可以安全地用于第二条插入（外键关联）
    _, err = db.Exec(
        "INSERT INTO related_table (t_id, remark) VALUES (?, 'from Go')",
        insertedID,
    )
    if err != nil {
        log.Fatal("插入从表失败:", err)
    }
}

需要留意几个关键点：

• `RETURNING ... INTO ?` 是 Oracle 原生的命令，go-oci8 驱动通过 `QueryRow` 加地址参数就能直接接收返回值；
• 必须使用 `QueryRow()`、`Get()` 或 `Select()`，不能用 `Exec()`——因为 `Exec()` 不支持返回值绑定；
• 虽然 sqlx 对命名参数也有支持，但 go-oci8 对命名参数的支持不太稳定，建议优先用位置占位符 `?`；
• 注意，`RETURNING` 是在同一个事务内原子执行的，不需要额外加锁，天生就保证了事务安全和并发安全；
• 无论你的主键是来自序列、UUID 函数还是 `SYS_GUID()`，只要 `RETURNING` 指定的是你的目标列，都能可靠拿回。

常见误区，挨个澄清一下

现在回过头看看，有几个坑是初学者最容易踩的：

• LastInsertId() 就不要想了：Oracle 的 Go 驱动（不管是 go-oci8 还是 goracle）都没有实现这个接口，调用就是报错；
• 千万别用 SELECT MAX(id) 来凑：高并发下读到别的会话插入的 ID 是很常见的事，还得加锁，性能也差；
• 存储函数里包 DML 再 SELECT 也不行：Oracle 禁止在 SELECT 中执行 DML，违反读一致性原则，会直接报 ORA-14551；
• PL/SQL 块加输出变量倒是可行：用 `sqlx.QueryRow().Scan()` 或 `database/sql` 的 `Out` 参数都能搞定，不过相比之下，`QueryRow(...).Scan(&id)` 是最简洁、最不容易出错的写法。

更进一步：封装成一个可复用的函数

如果这个操作在你的项目里出现的频率比较高，完全可以把它封装起来：

func InsertAndGetID(db *sqlx.DB, table, pkCol string, cols []string, values ...interface{}) (int, error) {
    placeholders := make([]string, len(cols))
    for i := range cols {
        placeholders[i] = "?"
    }
    query := fmt.Sprintf(
        "INSERT INTO %s (%s) VALUES (%s) RETURNING %s INTO ?",
        table,
        strings.Join(cols, ", "),
        strings.Join(placeholders, ", "),
        pkCol,
    )
    var id int
    err := db.QueryRow(query, append(values, &id)...).Err()
    return id, err
}

总的来说，在 Go 与 Oracle 配合的场景下，`INSERT ... RETURNING ... INTO ?` 就是获取新插入主键的标准答案。它既高效又安全，完美适配主-从表的级联插入需求，不需要额外查询，没有并发风险。可以说，这是每一位用 Go 操作 Oracle 的开发者都应该熟练掌握的基本功。