如何在 Go 中通过类型断言检测数值越界错误

go 的 `strconv` 包在解析整数失败时返回 `*strconv.numError`，其 `err` 字段可精确区分越界（`strconv.errrange`）与语法错误（`strconv.errsyntax`），需用类型断言提取并判断。

在 go 中处理字符串到整数的转换时，strconv.ParseInt 和 strconv.ParseUint 等函数虽能高效完成解析，但其错误类型并非单一接口，而是封装了具体原因的结构体——*strconv.NumError。该结构体包含 Func（出错函数名）、Num（原始输入字符串）和关键字段 Err（底层错误值），而 Err 正是判断错误本质的核心：若为 strconv.ErrRange，则明确表示数值超出了目标类型的表示范围（如 int64 的最大值为 9223372036854775807，而 “18446744073709551448” 显然远超此限）。

要可靠识别越界错误，必须进行两层检查：

1. 类型断言：确认 err 是否为 *strconv.NumError 类型；
2. 值比较：检查其 Err 字段是否等于 strconv.ErrRange。

以下是一个完整、健壮的示例：

package main  import (     "fmt"     "strconv" )  func main() {     s := "18446744073709551448"      // 尝试解析为 int64     iv, err := strconv.ParseInt(s, 10, 64)     if err != nil {         if numErr, ok := err.(*strconv.NumError); ok {             switch numErr.Err {             case strconv.ErrRange:                 fmt.Printf("❌ 越界错误：'%s' 超出 int64 表示范围n", s)                 // 此时可降级尝试 uint64 解析（如题中后续逻辑）                 if uv, err2 := strconv.ParseUint(s, 10, 64); err2 == nil {                     fmt.Printf("✅ 成功解析为 uint64: %dn", uv)                 } else {                     fmt.Printf("⚠️  同样超出 uint64 范围：%vn", err2)                 }                 return             case strconv.ErrSyntax:                 fmt.Printf("❌ 语法错误：'%s' 不是合法整数格式n", s)                 return             default:                 fmt.Printf("❌ 未知转换错误：%vn", err)                 return             }         }         // 非 NumError 类型的其他错误（极少见，但需兜底）         fmt.Printf("❌ 非数字转换错误：%vn", err)         return     }      fmt.Printf("✅ 成功解析为 int64: %dn", iv) }

注意事项：

• ✅ 必须使用 *strconv.NumError（带星号）进行断言，因为 strconv 返回的是指针类型；
• ✅ strconv.ErrRange 是一个导出的全局变量，可直接比较，无需反射或字符串匹配；
• ⚠️ 不要依赖 err.Error() 的字符串内容做判断（如 strings.Contains(err.Error(), “out of range”)），因其可能随 Go 版本变更，违反错误不可靠解析原则；
• ? 若需统一处理多种解析函数（ParseInt/ParseUint/ParseFloat），该模式完全通用，只需复用相同的 NumError 断言逻辑。

通过这种结构化错误处理，你不仅能精准响应越界场景，还能为用户提供清晰反馈，并安全地触发备用解析路径（如从 int64 切换到 uint64），显著提升程序鲁棒性与可维护性。