Go strconv.ParseInt 溢出时怎样保留错误信息

用 strconv.ParseInt 解析配置项、请求参数或数据库字段时，溢出并不会自动把返回值变成零。函数会返回一个经过边界收敛的 int64 值，同时返回包含原始字符串和原因的 *strconv.NumError。因此，正确做法是同时检查 err 和解析结果，不能只看结果值。

位宽决定边界，溢出值不会悄悄变成零

ParseInt(s, base, bitSize) 的第三个参数不是输出变量的类型提示，而是解析时必须满足的目标范围。bitSize=32 时，输入必须落在 -2147483648 到 2147483647 之间；即使函数的返回类型仍是 int64，也不能把超过这个范围的值当作合法的 64 位整数。

例如输入 2147483648、base=10、bitSize=32 时，返回值会贴近正向边界，并带有 strconv.ErrRange。这里的边界值只是诊断结果，不是可以继续写入业务对象的有效值。

用 NumError 和 errors.Is 同时保留上下文

只打印 err.Error() 能看到一行文本，但在日志分组、接口错误码或重试策略中，结构化字段更可靠。NumError 提供 Func、Num 和 Err；其中 Num 能保留触发问题的原始字符串。

package main

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

func main() {
	raw := "2147483648"
	value, err := strconv.ParseInt(raw, 10, 32)
	if err != nil {
		var numErr *strconv.NumError
		// As 保留函数名和原始输入，便于日志与接口错误映射。
		if errors.As(err, &numErr) {
			fmt.Printf("func=%s input=%s cause=%v\n", numErr.Func, numErr.Num, numErr.Err)
		}
		// Is 判断范围错误，不依赖错误文本的语言和格式。
		if errors.Is(err, strconv.ErrRange) {
			fmt.Println("value is outside int32 range")
		}
	}
	// 溢出时 value 可能是边界值，不能因它非零就继续使用。
	fmt.Println("returned value:", value)
}

这个例子里，errors.As 负责提取 *strconv.NumError，errors.Is 负责判断原因。两者分工不同：前者拿上下文，后者做稳定的分类判断。不要用 strings.Contains(err.Error(), "range") 代替它们。

包装错误时保留可判断的错误链

解析函数通常位于配置、HTTP 或数据访问层。向上返回时使用 %w 包装，调用方仍然可以识别 ErrRange；如果使用 %v，文本还在，但错误链会被截断。

func parseCount(raw string) (int64, error) {
	value, err := strconv.ParseInt(raw, 10, 32)
	if err != nil {
		// %w 让上层继续用 errors.Is / errors.As 判断原始原因。
		return 0, fmt.Errorf("count %q is invalid: %w", raw, err)
	}
	return value, nil
}

func readCount(raw string) error {
	_, err := parseCount(raw)
	if err == nil {
		return nil
	}
	// 先分类范围错误，再处理格式错误或其他原因。
	if errors.Is(err, strconv.ErrRange) {
		return fmt.Errorf("count exceeds int32 limit: %w", err)
	}
	if errors.Is(err, strconv.ErrSyntax) {
		return fmt.Errorf("count must be a decimal integer: %w", err)
	}
	return err
}

注意 readCount 返回错误时没有把边界值传出去。若业务确实需要记录返回值，也应把它当作诊断信息单独记录，并在错误非空时阻止写入、计费或分页计算。

把 ErrSyntax 和 ErrRange 分成两条处理路径

空字符串、非法数字或不符合指定进制的字符，通常归为 strconv.ErrSyntax，返回值为零；数值格式正确但超出位宽，则归为 strconv.ErrRange，返回值是目标位宽对应的最大幅度边界。两者都表示解析失败，但修复方向不同：前者检查输入格式，后者检查字段设计或数值范围。

落地时可以记住四项检查：base 是否固定、bitSize 是否对应协议、是否先判断 err、包装错误是否使用 %w。这四项比修改错误字符串更能避免溢出信息丢失。

相关问题

ParseInt 的 bitSize 传 0 和传 64 有什么区别？

0 按当前平台的 int 宽度约束，64 明确要求完整的 int64 范围。跨平台配置或协议字段不要靠默认值猜测。

为什么不能只判断返回值是否等于最大整数？

合法输入本身也可能正好等于边界值，只有配合 errors.Is(err, strconv.ErrRange) 才能确认这是溢出。

错误包装后还能用 errors.As 吗？

可以，只要每一层都用 %w 保留错误链，errors.As 仍能找到 *strconv.NumError。