3、错误码断言基础：什么是断言、断言在错误处理中的作用、assert语句的基本语法与使用场景

3.1 断言的核心概念

断言（Assertion）是一种在程序执行过程中嵌入的布尔检查机制。它用于验证某个关键条件是否成立——如果条件为真，程序继续执行；如果条件为假，程序立即终止并抛出错误信息。在报表错误处理与 Ent 错误码断言实战中，断言是连接预期行为与实际结果的“守门员”。

3.2 断言在错误处理中的作用

在报表开发和 Ent 错误码处理中，断言承担以下四个关键角色：

3.3 assert 语句的基本语法

不同语言对断言的支持略有差异，但核心模式一致。以下以 Go 语言（Ent 框架的宿主语言）和 Python 为例展示基本语法：

Go 语言（使用 testify/assert 包）

import (
    "testing"
    "github.com/stretchr/testify/assert"
)

func TestReportErrorCode(t *testing.T) {
    // 基本断言：检查错误是否为 nil
    err := generateReport()
    assert.NoError(t, err, "生成报表不应返回错误")

    // 断言错误类型：检查是否为特定 Ent 错误码
    _, err = client.User.Get(ctx, 999)
    assert.True(t, ent.IsNotFound(err), "查询不存在的用户应返回 NotFound 错误码")

    // 断言值相等
    assert.Equal(t, 100, len(report.Rows), "报表行数应为 100")

    // 断言条件为真
    assert.Condition(t, func() bool {
        return report.TotalAmount > 0
    }, "报表总金额必须大于 0")
}

Python（使用内置 assert 语句）

def test_report_error_code():
    # 基本断言
    result = generate_report()
    assert result is not None, "报表对象不应为 None"

    # 断言错误码类型
    error_code = get_ent_error_code(999)
    assert error_code == "NotFound", f"预期 NotFound，实际得到 {error_code}"

    # 断言数值范围
    assert 0 < len(result.rows) <= 1000, "报表行数应在 1~1000 之间"

    # 断言集合包含
    assert "ERR_NOT_FOUND" in error_map, "错误码映射必须包含 ERR_NOT_FOUND"

3.4 断言的使用场景与边界

断言并非万能工具，它有明确的使用边界。以下表格对比了适合使用断言与不适合使用断言的场景：

3.5 断言在 Ent 错误码断言中的典型流程

下图展示了在 Ent 错误码断言实战中，断言如何嵌入到测试流程中：

3.6 断言使用的最佳实践清单

• 断言单一条件：每个断言只验证一个逻辑条件，便于定位失败原因。
• 提供清晰的消息：在断言中附加描述性消息，说明预期行为。
• 优先使用类型断言函数：在 Ent 错误码断言中，使用 ent.IsNotFound()、ent.IsConstraintError() 等专用函数，而非手动比较字符串。
• 避免在断言中执行副作用：断言表达式不应修改程序状态或调用有副作用的函数。
• 区分测试断言与生产断言：测试中的断言使用 assert.* 函数，生产代码中的断言使用 require.* 或内置 assert 关键字。
• 断言错误码的精确类型：不要只断言 err != nil，要断言具体的错误码类型，确保错误处理逻辑的正确性。