Go问答：sql.RowsAffected返回 0 时怎样区分没有匹配和事务未提交

在 Go 的 database/sql 中，Result.RowsAffected() 返回的是当前 SQL 语句报告的影响行数。它不是事务提交结果，也不能单独证明“事务还没有提交”。因此看到返回值为 0 时，应先检查 WHERE 条件和驱动对结果的定义，再单独处理 Commit 的错误。

这篇只讨论更新或删除后的 0 行结果，不把它扩展成通用事务设计。最稳妥的记录方式是把“执行错误、影响行数、提交错误、事务内读取结果”分成四个字段保存。

RowsAffected 的 0 到底说明什么

对 UPDATE 或 DELETE 来说，0 通常表示当前语句没有报告受影响的行，但原因要结合 SQL 条件和驱动实现判断：可能没有记录满足条件，也可能驱动把“值没有实际变化”按自己的约定报告为 0。它不等于数据库拒绝了提交，更不等于事务一定回滚。

另一个容易混淆的点是：RowsAffected 描述的是语句结果，而“其他连接什么时候能看到数据”属于事务可见性问题。即使它返回了非零值，只要事务还没有成功提交，外部连接也不应据此认为修改已经对外生效。

用明确的条件判断是否真的匹配到记录

把业务条件写进 SQL，并在代码中同时保存影响行数和错误。例如使用版本号做乐观并发控制时，0 可以作为“版本条件没有命中”的信号，但仍要把驱动错误与业务判断分开：

// 用版本条件保护更新，并把 SQL 错误与业务上的 0 行分开处理。
result, err := tx.ExecContext(ctx,
    `UPDATE profiles
        SET nickname = ?, version = version + 1
      WHERE user_id = ? AND version = ?`,
    nickname, userID, expectedVersion,
)
if err != nil {
    // ExecContext 失败时，不能把它简化成 RowsAffected 为 0。
    return fmt.Errorf("更新 profile 失败: %w", err)
}

affected, err := result.RowsAffected()
if err != nil {
    // 某些驱动可能不支持读取影响行数，保留原始错误便于定位。
    return fmt.Errorf("读取影响行数失败: %w", err)
}
if affected == 0 {
    // 这里表示没有得到受影响行的报告，需结合条件和驱动约定继续判断。
    return ErrVersionConflict
}

// 只有 Commit 成功，事务外的读取才可以按已提交结果继续处理。
if err := tx.Commit(); err != nil {
    return fmt.Errorf("提交事务失败: %w", err)
}
return nil

这个写法的关键不是把 0 当作万能错误码，而是让每个观察点有自己的含义：ExecContext 判断语句是否执行，RowsAffected 判断结果是否可读，业务分支解释 0，Commit 决定事务是否成功结束。

怎样排除“事务还没提交”的误判

事务未提交应看 Commit() 的返回值，而不是看 RowsAffected()。若在事务中需要确认当前连接能否读到修改，可以在同一个 tx 上读取；若要确认外部连接的可见性，则应在提交成功后再由新的查询流程读取。

// 在同一个 Tx 内读取，用于确认当前事务自己的视图；不要把它当成外部可见性证明。
var version int
if err := tx.QueryRowContext(ctx,
    `SELECT version FROM profiles WHERE user_id = ?`, userID,
).Scan(&version); err != nil {
    // 查询不到记录与连接/扫描错误要保留不同的处理路径。
    return fmt.Errorf("事务内读取版本失败: %w", err)
}

if err := tx.Commit(); err != nil {
    // 提交失败时，事务外不能继续使用“已经更新”的结论。
    return fmt.Errorf("提交更新失败: %w", err)
}

// 到这里才进入事务外的后续读取或消息通知流程。
return nil

需要区分“未匹配”和“值没变化”怎么办

如果业务必须区分“没有这条记录”“版本不对”和“新旧值相同”，只依赖一个影响行数通常不够。可以先用同样的业务条件查询当前版本，再执行带版本条件的更新；也可以让 SQL 增加明确的版本字段、状态字段或审计记录。这样判断依据来自业务字段，而不是猜测驱动把 0 解释成了哪一种情况。

同时要查阅所用驱动对 Result 的约定，因为 database/sql 暴露的是通用接口，具体数据库对“匹配行”和“实际改变行”的统计可能存在差异。驱动不支持影响行数时，应把 RowsAffected 的错误记录下来，不能静默当成 0。

常见问题

RowsAffected 为 0 是否一定表示 WHERE 没有命中？

不一定。还要考虑驱动统计语义、值是否真的变化以及 SQL 是否被正确执行。

Commit 成功但 RowsAffected 为 0，事务算成功吗？

事务可以成功提交，但这只说明事务结束成功，不代表一定修改了记录。是否算业务成功应由匹配条件和业务规则决定。

能否用事务外查询判断事务是否提交？

可以把提交后的事务外查询作为可见性检查，但不要把查询不到简单归因于 RowsAffected 为 0；应同时记录提交错误、查询条件和连接上下文。