1. 错误码基础：Ent 错误码的定义、错误码在 ORM 中的角色、为什么需要错误码断言

1.3 为什么需要错误码断言

在 Go 语言中，错误处理通常依赖 if err != nil 模式。但在 ORM 场景下，仅判断错误是否存在远远不够，原因如下：

1.3.1 避免字符串匹配的脆弱性

传统做法是解析错误字符串：

if strings.Contains(err.Error(), "Duplicate entry") {
    // 处理唯一约束冲突
}

这种方式的缺陷：

• 数据库方言依赖： MySQL 返回 "Duplicate entry"，PostgreSQL 返回 "duplicate key value"，SQLite 返回 "UNIQUE constraint failed"。
• 版本敏感： 驱动升级可能改变错误消息格式。
• 性能低下： 字符串匹配比整数比较慢 1~2 个数量级。

1.3.2 错误码断言的优势

1.3.3 典型业务场景

错误码断言在以下场景中不可或缺：

• 用户注册： 捕获 UniqueConstraint 返回 "邮箱已被注册" 而非 500 错误。
• 级联删除： 捕获 ForeignKeyConstraint 提示 "存在关联订单，无法删除用户"。
• 幂等创建： 对 UniqueConstraint 忽略错误，实现 "不存在则创建" 语义。
• 查询容错： 对 NotFound 返回空对象而非中断流程。

1.4 错误码断言的基本用法

Ent 提供了两个核心断言函数，位于 entgo.io/ent/dialect/sql/sqlgraph 包：

import "entgo.io/ent/dialect/sql/sqlgraph"

// 判断是否为约束类错误（UniqueConstraint / ForeignKeyConstraint / Constraint）
if sqlgraph.IsConstraintError(err) {
    // 约束违反处理
}

// 判断具体错误码
if sqlgraph.HasErrorCode(err, sqlgraph.UniqueConstraint) {
    // 唯一约束违反处理
}

// 判断是否为未找到错误
if sqlgraph.IsNotFound(err) {
    // 记录不存在处理
}

// 判断是否为非唯一查询错误
if sqlgraph.IsNotSingular(err) {
    // 查询结果不唯一处理
}