当前位置：首页 > 文章列表 > Golang > Go教程 > Go strconv.NumError 怎么拿到具体转换字段

Go strconv.NumError 怎么拿到具体转换字段

来源：17golang原创 2026-09-09 18:53:45 0浏览收藏

调用 strconv.ParseInt、strconv.ParseFloat 失败时，err.Error() 往往只是一整句文本。要拿到“哪个转换函数失败、用户传入了什么、失败原因是什么”，应使用 errors.As 把错误取回 *strconv.NumError，再读取它的 Func、Num 和 Err 字段。不要靠切割错误字符串来猜字段。

要点速览

Func 是失败的转换函数名，Num 是原始输入，Err 是底层转换原因。
用 errors.As 兼容被包装过的错误，用 errors.Is 判断 ErrSyntax 或 ErrRange。
ParseInt 即使返回范围错误，也可能带有一个截断后的数值；业务代码必须先判断 err。

先判断 err 里是不是 *strconv.NumError

下面的例子故意把 bitSize 设为 8，并传入超出 int8 范围的字符串。这样既能看到错误对象，也能区分“输入不是数字”和“数字太大”两类问题。

package main

import (
    "errors"
    "fmt"
    "strconv"
)

func inspect(raw string) {
    // bitSize=8 表示目标范围按 int8 判断，便于演示范围错误。
    value, err := strconv.ParseInt(raw, 10, 8)
    if err == nil {
        fmt.Println("value:", value)
        return
    }

    var numErr *strconv.NumError
    // errors.As 能沿着包装链寻找 *strconv.NumError，比直接断言更稳妥。
    if errors.As(err, &numErr) {
        fmt.Println("Func:", numErr.Func)
        fmt.Println("Num:", numErr.Num)
        fmt.Println("Err:", numErr.Err)
        return
    }

    // 非 NumError 仍要保留兜底分支，避免丢失未知错误。
    fmt.Println("other error:", err)
}

func main() {
    inspect("256")
    inspect("2x")
}

Go strconv.NumError 从 ParseInt 转换入口连接到 Func、Num、Err 字段的静态结构 — 图1：转换入口返回 error 后，*strconv.NumError 将失败函数、原始输入和底层原因放在同一个错误对象中。

这里的关键不是把 err 强行断言成某个类型，而是让 errors.As 沿着错误包装链查找目标类型。当前错误若来自 ParseInt、ParseUint、ParseFloat 或 ParseComplex，通常都能得到对应的 *strconv.NumError。

Func、Num、Err 三个字段分别看什么

NumError 是一个记录转换失败的结构体，三个字段的用途很明确：

字段	含义	适合怎么用
`Func`	失败的函数名，例如 `ParseInt`	日志里定位是哪一种转换规则生效
`Num`	参与转换的原始字符串	关联表单字段、CSV 列或配置项的原始值
`Err`	底层原因，例如 `ErrSyntax`、`ErrRange`	决定提示“格式不对”还是“超出范围”

err.Error() 适合给日志或调试输出看，但不适合当作程序接口。错误文本可能包含引号和具体输入；业务判断应直接使用字段与标准错误值。

Go strconv.NumError 的 Func、Num、Err 三个字段与转换输入和业务日志边界的静态关系 — 图2：Func、Num、Err 共同描述一次转换失败，输入校验层读取它们后再分别连接到日志和用户提示。

用 errors.Is 区分语法错误和范围错误

拿到 NumError 后，不要只比较 numErr.Err.Error() 的字符串。标准库提供的 strconv.ErrSyntax 表示输入语法不符合目标类型，strconv.ErrRange 表示值超出了指定大小的可表示范围。

func message(raw string) string {
    // 先保留 err，不能因为 ParseInt 返回了数值就认为转换成功。
    _, err := strconv.ParseInt(raw, 10, 8)
    if err == nil {
        return "输入有效"
    }

    if errors.Is(err, strconv.ErrSyntax) {
        // 语法错误适合提示用户检查数字格式。
        return "请输入合法的整数"
    }
    if errors.Is(err, strconv.ErrRange) {
        // 范围错误要提示可接受区间或调整目标类型。
        return "整数超出当前字段的取值范围"
    }
    return "数字转换失败"
}

由于 *strconv.NumError 实现了 Unwrap，errors.Is(err, strconv.ErrSyntax) 可以直接从外层错误找到底层原因。若你只比较 err == strconv.ErrSyntax，通常会因为外层是 *NumError 而判断失败。