2. Go 语言基础回顾：模块管理、常用数据结构、接口与错误处理

在构建权限审计网关之前，必须夯实 Go 语言的核心基础。本章聚焦于四个关键领域：模块管理（依赖与版本）、常用数据结构（slice 与 map）、接口（抽象与多态）以及错误处理（惯用模式）。这些知识点将直接应用于后续的网关路由、中间件链、审计日志存储和权限校验逻辑中。

2.1 Go 模块管理

Go 模块（Module）是 Go 1.11 引入的官方依赖管理方案，通过 go.mod 文件定义项目根目录和依赖版本。权限审计网关作为多模块项目，需要清晰管理内部包和外部依赖。

2.2 常用数据结构：slice 与 map

Slice 和 map 是 Go 中最常用的两种引用类型，在网关的请求处理、路由匹配、中间件链管理中频繁出现。

2.2.1 Slice：动态数组

Slice 是对底层数组的视图，包含指针、长度和容量三个属性。在网关中，slice 常用于存储中间件列表、审计日志条目、权限列表等。

// 声明与初始化
var middlewareChain []string
middlewareChain = append(middlewareChain, "auth", "rate-limit", "audit")

// 子切片操作（左闭右开）
sub := middlewareChain[1:3] // ["rate-limit", "audit"]

// 遍历
for i, name := range middlewareChain {
    fmt.Printf("middleware[%d] = %s\n", i, name)
}

// 注意：append 可能触发底层数组扩容，导致性能抖动
// 预分配容量可避免多次扩容
chain := make([]string, 0, 10) // 初始容量 10

2.2.2 Map：键值对集合

Map 是 Go 内置的哈希表实现，在网关中用于路由表、用户会话、配置缓存等场景。注意 map 不是并发安全的，需要加锁或使用 sync.Map。

// 声明与初始化
routeMap := make(map[string]string)
routeMap["/api/v1/users"] = "user_handler"
routeMap["/api/v1/roles"] = "role_handler"

// 安全读取（逗号 ok 模式）
if handler, ok := routeMap["/api/v1/users"]; ok {
    fmt.Println("Found handler:", handler)
} else {
    fmt.Println("Route not found")
}

// 删除
delete(routeMap, "/api/v1/roles")

// 遍历（无序）
for path, handler := range routeMap {
    fmt.Printf("%s -> %s\n", path, handler)
}

2.3 接口与多态

Go 的接口是隐式实现的，只要类型实现了接口的所有方法，就自动满足该接口。在权限审计网关中，接口用于定义插件化的中间件、存储后端、认证策略等。

// 定义审计存储接口
type AuditStore interface {
    Save(entry AuditEntry) error
    Query(userID string, start, end time.Time) ([]AuditEntry, error)
}

// MySQL 实现
type MySQLAuditStore struct {
    db *sql.DB
}

func (m *MySQLAuditStore) Save(entry AuditEntry) error {
    // 实现 MySQL 写入逻辑
    return nil
}

func (m *MySQLAuditStore) Query(userID string, start, end time.Time) ([]AuditEntry, error) {
    // 实现 MySQL 查询逻辑
    return nil, nil
}

// 使用接口作为函数参数（依赖注入）
func ProcessAudit(store AuditStore, entry AuditEntry) error {
    return store.Save(entry)
}

2.4 错误处理

Go 没有异常机制，错误通过返回值传递。在网关中，错误处理直接影响请求的响应状态和审计记录的完整性。

2.4.1 基本模式

// 标准错误返回
func ValidateToken(token string) (UserInfo, error) {
    if token == "" {
        return UserInfo{}, errors.New("token cannot be empty")
    }
    // 验证逻辑...
    return UserInfo{ID: "123", Role: "admin"}, nil
}

// 调用方处理
user, err := ValidateToken(reqToken)
if err != nil {
    // 记录审计日志
    auditLog.Error("token validation failed", "error", err)
    // 返回 HTTP 401
    c.JSON(http.StatusUnauthorized, gin.H{"error": err.Error()})
    return
}

2.4.2 自定义错误类型

在网关中，定义业务错误类型可以携带更多上下文信息，便于审计和调试。

// 自定义错误类型
type AuthError struct {
    Code    int    // 错误码
    Message string // 用户可见消息
    Err     error  // 内部错误
}

func (e *AuthError) Error() string {
    return fmt.Sprintf("auth error [%d]: %s", e.Code, e.Message)
}

func (e *AuthError) Unwrap() error {
    return e.Err
}

// 使用 errors.Is 和 errors.As 进行错误链判断
if errors.Is(err, ErrTokenExpired) {
    // 处理令牌过期
}

2.5 本章小结

• 模块管理：使用 go.mod 和 go mod tidy 管理依赖，确保构建可重复。
• Slice：动态数组，注意扩容开销和共享底层数组的副作用。
• Map：哈希表，非并发安全，使用逗号 ok 模式安全读取。
• 接口：隐式实现，支持多态和依赖注入，是网关插件化的基础。
• 错误处理：显式检查错误，使用自定义错误类型携带上下文，避免忽略错误。