Go strconv.Atoi 解析带空格数字失败怎么处理

把表单、环境变量或文本协议里的 " 42 " 直接交给 strconv.Atoi，常见结果不是 42，而是 invalid syntax。原因很简单：Atoi 负责把合法的十进制字符串转成 int，不会替调用方猜测“这些空格是否应该被忽略”。

如果业务允许输入两端留白，先用 strings.TrimSpace 再调用 strconv.Atoi；如果空格意味着数据不合规，就保留原字符串并直接拒绝。不要把两种契约混在一个通用函数里。

Atoi 为什么遇到空格就失败

官方文档把 Atoi 定义为 ParseInt(s, 10, 0) 的便捷入口。也就是说，输入会按十进制整数语法解析；字符串前后的空格、换行或制表符并不是数字本身的一部分，因此不会自动被跳过。strings.TrimSpace 是独立的清洗动作，不是 Atoi 的隐含步骤。

要注意“首尾空白”和“内嵌空格”不是一回事。" 42 " 经过裁剪可以得到 42；"4 2" 经过裁剪仍是 "4 2"，它不应被悄悄改成 42。

先决定字段是宽松输入还是严格输入

来自用户表单的数字通常允许复制粘贴带来的首尾空白，配置文件的关键字段或协议字段则可能要求原样匹配。先把这个决定写进代码，后面排错才不会出现“同一个接口有时接受、有时拒绝”的差异。

允许外层空白时，把清洗和解析分成两个清晰动作：

func parseLooseInt(raw string) (int, error) {
    cleaned := strings.TrimSpace(raw) // 只清理两端空白，不删除数字中间的空格
    if cleaned == "" {
        return 0, fmt.Errorf("数字字段不能为空") // 空值单独处理，避免把原因藏在语法错误里
    }
    n, err := strconv.Atoi(cleaned) // 仍然按十进制 int 解析
    if err != nil {
        return 0, fmt.Errorf("解析数量 %q: %w", raw, err) // 保留原输入，便于定位来源
    }
    return n, nil
}

严格模式则不要调用 TrimSpace 后继续解析，而是先比较前后字符串：

func parseStrictInt(raw string) (int, error) {
    if raw == "" {
        return 0, fmt.Errorf("数字字段不能为空") // 空字符串不是可接受的整数
    }
    if raw != strings.TrimSpace(raw) {
        return 0, fmt.Errorf("数字字段不能包含首尾空白") // 保留契约：输入必须原样干净
    }
    n, err := strconv.Atoi(raw)
    if err != nil {
        return 0, fmt.Errorf("无效整数 %q: %w", raw, err) // 向上层保留原始 NumError
    }
    return n, nil
}

用错误类型区分格式和范围

Atoi 失败时返回的错误可能是语法错误，也可能是目标 int 宽度容纳不下。不要只比较完整错误字符串；用 errors.As 取出 *strconv.NumError，再用 errors.Is 判断 strconv.ErrSyntax 或 strconv.ErrRange。

n, err := strconv.Atoi(cleaned)
if err != nil {
    var numErr *strconv.NumError
    if errors.As(err, &numErr) && errors.Is(numErr.Err, strconv.ErrRange) {
        return fmt.Errorf("整数超出 int 范围: %w", err) // 提示调用方缩小数值或改用更宽类型
    }
    if errors.As(err, &numErr) && errors.Is(numErr.ErrSyntax) {
        return fmt.Errorf("整数格式不正确: %w", err) // 空格、字母和小数点会落到这里
    }
    return fmt.Errorf("整数解析失败: %w", err) // 保留未来错误类型的可扩展分支
}
_ = n

这里的检查顺序也有意义：空值和字段契约属于输入层，ErrSyntax 属于格式层，ErrRange 属于数值边界层。分层后，接口可以分别返回“请填写”“格式错误”或“超出范围”，而不是统一显示“解析失败”。

发布前的最小回归清单

至少覆盖以下五种样例：普通数字、首尾空白、内嵌空格、全空白和超出当前平台 int 范围的数字。若数据来自换行文本，顺手加入 \n、\t；若是协议字段，则明确测试严格模式是否拒绝它们。核心检查不是“TrimSpace 能不能让示例通过”，而是清洗规则是否和字段契约一致。

常见问题

只想去掉半角空格，还要用 TrimSpace 吗？

如果业务只允许 ASCII 空格，应使用更窄的规则并明确记录；TrimSpace 面向 Unicode 空白，范围更宽。

Atoi 能直接解析小数或千分位吗？

不能。小数应考虑 ParseFloat，千分位需要先定义格式并单独清洗，不能把逗号随意删除。

为什么错误里会出现 strconv.NumError？

它携带函数名、原始字符串和底层错误，适合用 errors.As 取得结构化信息；日志里可保留，但返回给用户时应转换成业务提示。

严格模式是否比 TrimSpace 更安全？

没有绝对答案。严格模式更适合协议和配置校验，TrimSpace 更适合容忍人工输入；关键是同一字段始终执行同一契约。