1. 事务边界概念：什么是事务边界、事务的 ACID 特性、在 Go API 中事务边界的意义

1.1 事务边界：从数据库到 API 的映射

事务边界（Transaction Boundary）是分布式系统与数据库交互中最基础也最容易被忽视的概念。它定义了一组操作被视为一个不可分割的逻辑单元的起始与结束位置。在传统数据库中，事务边界由 BEGIN 和 COMMIT（或 ROLLBACK）显式划定；而在 Go API 中，事务边界需要跨越网络请求、服务调用和数据持久化三个层次。

1.2 事务的 ACID 特性速查表

1.3 事务边界在 Go API 中的三层映射

一个典型的 Go API 请求从进入路由到返回响应，事务边界需要跨越以下三个层次：

1. 传输层边界：HTTP 请求/响应的生命周期。一个请求对应一个事务上下文。
2. 业务层边界：Service 方法内多个 Repository 调用的组合。事务在此层开启和提交。
3. 持久层边界：数据库连接上的 BEGIN / COMMIT / ROLLBACK。Go 的 database/sql 标准库通过 sql.Tx 对象管理。

1.4 事务边界在 Go API 中的意义

• 保证数据完整性：事务边界确保跨表、跨服务的写操作要么全部生效，要么全部撤销，避免"部分成功"的脏数据。
• 契约校验的锚点：事务边界是执行契约校验的最佳时机——在 BEGIN 之后、COMMIT 之前，对请求体、业务规则、数据约束做全面检查。
• 隔离并发冲突：通过事务边界内的隔离级别设置，控制并发请求对同一数据的读写可见性，防止脏读、不可重复读、幻读。
• 可观测性与回滚策略：明确的事务边界让日志、监控、错误处理有了清晰的上下文。回滚时能精确知道哪些操作需要撤销。

1.5 事务边界与契约校验的关系图

1.6 Go 代码示例：事务边界的最小实现

// 事务边界的最小 Go 实现示例
func CreateOrder(ctx context.Context, db *sql.DB, req CreateOrderRequest) error {
    // 前置契约校验（在事务边界之外）
    if err := validateCreateOrder(req); err != nil {
        return fmt.Errorf("契约校验失败: %w", err)
    }

    // 开启事务边界
    tx, err := db.BeginTx(ctx, &sql.TxOptions{
        Isolation: sql.LevelReadCommitted,
    })
    if err != nil {
        return fmt.Errorf("开启事务失败: %w", err)
    }
    // 确保事务最终关闭（Commit 或 Rollback）
    defer tx.Rollback() // 如果已 Commit，Rollback 是空操作

    // 事务边界内的业务操作
    if err := insertOrder(tx, req.Order); err != nil {
        return fmt.Errorf("插入订单失败: %w", err)
    }
    if err := deductInventory(tx, req.Items); err != nil {
        return fmt.Errorf("扣减库存失败: %w", err)
    }

    // 后置契约校验（仍在事务边界内）
    if err := validateAfterWrite(tx, req); err != nil {
        return fmt.Errorf("后置校验失败: %w", err)
    }

    // 提交事务，结束事务边界
    if err := tx.Commit(); err != nil {
        return fmt.Errorf("提交事务失败: %w", err)
    }
    return nil
}