1. 安全错误码概述

1.1 错误码在 Go 安全体系中的角色

在 Go 语言的安全工程实践中，错误码并非简单的状态标识，而是安全防线中的关键断言节点。每一个错误码的生成、传递与处理，都对应着一次安全决策的边界判定。错误码在安全体系中承担以下核心角色：

• 安全边界指示器：错误码标记了系统在认证、授权、输入校验等环节的边界状态，是安全策略是否生效的直接证据。
• 攻击行为传感器：异常错误码序列（如连续 401/403）可被安全监控系统捕获，用于识别暴力破解、越权扫描等攻击行为。
• 审计溯源锚点：每个错误码在日志中形成可追溯的安全事件锚点，支撑事后审计与取证分析。
• 防御纵深节点：错误码处理逻辑本身构成防御纵深的一环，错误的错误码处理（如信息泄露、吞没异常）会直接削弱整体安全水位。

1.2 常见安全错误码分类

根据安全攻防的典型场景，Go 应用中的安全错误码可划分为以下四大类。每一类对应不同的攻击面与防御策略。

1.3 安全错误码在 Go 中的断言模式

Go 语言通过 error 接口实现错误传递，安全错误码的断言模式通常包含以下三种：

1. 值断言：通过 errors.Is() 或 == 比较预定义的哨兵错误，适用于认证/授权类错误码。
2. 类型断言：通过 errors.As() 提取自定义错误类型中的安全上下文，适用于需要携带额外安全属性的错误码。
3. 状态码断言：在 HTTP/gRPC 等协议层，通过响应状态码映射到内部安全错误码，适用于 API 网关层的统一安全策略。

// 值断言示例：认证错误码
var ErrUnauthorized = errors.New("auth: unauthorized")

func validateToken(token string) error {
    if token == "" {
        return ErrUnauthorized
    }
    // ... 验证逻辑
    return nil
}

// 审计时：检查调用方是否使用 errors.Is() 而非 ==
if errors.Is(err, ErrUnauthorized) {
    // 安全处理：记录审计日志，不泄露具体原因
}

1.4 安全错误码生命周期与审计节点

下图展示了安全错误码从生成到最终处理的完整生命周期，以及每个阶段对应的审计节点。

1.5 安全错误码断言审计的核心原则

在 Go 安全审计中，针对错误码断言需遵循以下四项核心原则：

1.6 安全错误码与 Go 标准库的集成模式

Go 标准库中的 net/http、database/sql、crypto 等包均定义了各自的安全相关错误码。审计时需关注这些标准错误码在应用层是否被正确断言和转换。

// 标准库安全错误码示例
var (
    // net/http 相关
    ErrBodyNotAllowed = errors.New("http: request method or response status code does not allow body")
    ErrHijacked       = errors.New("http: connection has been hijacked")

    // crypto/tls 相关
    ErrCertificateExpired = errors.New("x509: certificate has expired or is not yet valid")
    ErrHostnameMismatch   = errors.New("x509: certificate is valid for ... not ...")
)

// 审计要点：应用层是否对标准库安全错误码进行了二次断言？
// 反模式：直接返回标准库错误码给客户端
func handler(w http.ResponseWriter, r *http.Request) {
    err := tlsHandshake(r)
    if err != nil {
        // 错误：直接返回标准库错误，泄露 TLS 细节
        http.Error(w, err.Error(), http.StatusInternalServerError)
        return
    }
}

// 正确模式：将标准库错误码映射为安全错误码
func handlerSecure(w http.ResponseWriter, r *http.Request) {
    err := tlsHandshake(r)
    if err != nil {
        if errors.Is(err, x509.ErrCertificateExpired) {
            // 安全：映射为通用认证错误，不泄露证书细节
            writeSecureError(w, ErrAuthFailed)
            logAudit("cert_expired", r.RemoteAddr)
            return
        }
        writeSecureError(w, ErrInternal)
        logAudit("tls_unknown", r.RemoteAddr)
    }
}

1.7 安全错误码分类的审计优先级

根据 OWASP Top 10 与 Go 安全实践，四大类安全错误码的审计优先级排序如下：

1. 认证错误码（最高优先级）：直接关联身份安全，错误处理不当可导致账户枚举、暴力破解加速。
2. 授权错误码（高优先级）：越权漏洞的最后一公里防线，错误码断言缺失可直接导致越权攻击成功。
3. 输入校验错误码（中优先级）：错误信息泄露是注入攻击的重要信息源，但影响面取决于错误码的暴露范围。
4. 资源泄漏错误码（中优先级）：虽不直接导致数据泄露，但可被用于 DoS 攻击或触发连锁故障。