📚 课程目录第1章课程导论

1. 课程导论：什么是 Ent ORM、为什么需要可观测事务边界、课程目标与前置知识

1.1 什么是 Ent ORM

Ent 是 Facebook 开源的一款实体关系映射（ORM）框架，专为 Go 语言设计。与传统的 ORM（如 GORM、XORM）不同，Ent 采用代码生成（Code Generation）的方式，从 Schema 定义自动生成类型安全的数据库操作代码。它的核心设计哲学是：Schema as Code——开发者用 Go 结构体定义数据模型，Ent 编译器生成强类型的 CRUD、关联查询、迁移脚本。

  Ent 的核心特性：
  类型安全：所有查询在编译期检查，杜绝运行时字段拼写错误。
图遍历：原生支持 Eager Loading、嵌套查询、跨表关联。
自动迁移：Schema 变更自动生成 ALTER TABLE 语句。
可扩展：支持 Hook、中间件、自定义 SQL、多数据库后端。

以下是一个典型的 Ent Schema 定义示例：

// ent/schema/user.go
package schema

import (
    "entgo.io/ent"
    "entgo.io/ent/schema/field"
)

type User struct {
    ent.Schema
}

func (User) Fields() []ent.Field {
    return []ent.Field{
        field.String("name").NotEmpty(),
        field.Int("age").Positive(),
        field.Time("created_at").Default(time.Now),
    }
}

func (User) Edges() []ent.Edge {
    return []ent.Edge{
        edge.To("posts", Post.Type),
    }
}

Ent 生成的代码允许开发者以链式调用的方式执行查询：

// 生成的强类型客户端
users, err := client.User.
    Query().
    Where(user.Name("Alice")).
    WithPosts(func(q *ent.PostQuery) {
        q.Where(post.TitleContains("Go"))
    }).
    All(ctx)

1.2 为什么需要可观测事务边界

在微服务与分布式系统中，数据库事务不再是简单的 ACID 黑盒。事务的边界——即事务从开启到提交/回滚的完整生命周期——往往跨越多个服务、多个数据库、甚至多个消息队列。当系统出现性能瓶颈或数据不一致时，开发者面临以下痛点：

痛点	典型场景	后果
事务悬空	事务开启后未提交也未回滚，连接池耗尽	服务雪崩、数据库连接泄漏
慢事务	事务内包含慢查询或远程 RPC 调用	锁持有时间过长，死锁概率上升
分布式事务不一致	Saga 或 TCC 模式中某一步失败	数据最终不一致，需要人工修复
事务嵌套失控	Hook 或中间件中隐式开启新事务	意外回滚、脏写、难以排查

可观测事务边界是指在事务的每个关键节点（Begin、Query、Exec、Commit、Rollback、Nested）注入可观测性数据，包括：

Trace：事务在整个调用链中的位置与耗时。
Metric：事务成功率、延迟分布、活跃事务数。
Log：事务上下文、SQL 语句、影响行数、错误详情。

核心观点：没有可观测性的事务边界，就像在黑暗中驾驶——你永远不知道事务是正常结束、正在等待锁、还是已经死锁。Ent 的 Hook 机制为事务边界的可观测性提供了天然的切入点。

1.3 课程目标

本课程旨在帮助 Go 后端工程师、SRE 与架构师掌握以下能力：

理解 Ent 事务模型：Tx 对象、嵌套事务、SavePoint、事务 Hook 链。
构建可观测事务边界：在 Ent 的 Hook 中集成 OpenTelemetry Tracing、Prometheus Metrics、结构化日志。
实战落地：从单体应用到微服务，从单库到分布式事务，逐步构建生产级的事务可观测性方案。
故障排查与优化：通过可观测数据定位慢事务、死锁、悬空事务，并给出优化策略。

章节模块	核心产出
基础篇（1-5 章）	Ent 事务模型 + 基础 Hook 实现
可观测篇（6-15 章）	Trace/Metric/Log 完整接入
进阶篇（16-25 章）	分布式事务、多数据库、性能优化
实战篇（26-30 章）	生产级可观测事务边界 SDK 与最佳实践

1.4 前置知识

注意：本课程假设你已经具备以下基础。如果对某些领域不熟悉，建议先阅读推荐资料。

Go 语言基础：接口、结构体、错误处理、context.Context。推荐阅读《The Go Programming Language》。
数据库基础：SQL 事务（ACID）、隔离级别、锁机制。推荐阅读《高性能 MySQL》第 1-5 章。
Ent 基础：Schema 定义、CRUD 操作、关联查询。推荐阅读 Ent 官方文档的 Getting Started。
可观测性基础：了解 Tracing、Metrics、Logging 的基本概念。推荐阅读 OpenTelemetry 官方文档。