Go 接口转换 panic — 动态类型不符

症状

遇到“Go 接口转换 panic — 动态类型不符”时靠猜测只会浪费时间。请按证据排查：先复现症状，再执行针对性诊断，定位根因后修复，并用明确检查验证结果。

可观察到的症状包括：

• panic: interface conversion: interface {} is string, not int
• panic 列出了两个意想不到的具体类型
• 仅对某些 JSON 或 map 输入才失败

诊断

先在隔离环境中复现故障，再按顺序执行以下检查，逐步缩小范围。

步骤 1

go run - <<'EOF'
package main
import "fmt"
func main(){ var v any = "7"; n := v.(int); fmt.Println(n) }
EOF

panic 消息给出实际类型与断言类型，据此可修正断言或输入。

步骤 2

n, ok := v.(int); if !ok { /* handle */ }

双值断言不会 panic，可在类型不符时分支处理而非崩溃。

常见诱因（按出现频率排序）：

• 在 x 可能持有其他动态类型处使用了单值断言 v := x.(T)
• JSON 数字解码为 float64，断言为 int 会 panic
• map 中以某类型存入，读取时却假定为另一类型

根因

当 x 的动态类型并非恰好为 T 时，单值类型断言 x.(T) 会 panic。JSON 与接口密集的代码常存入意外的具体类型，因此不安全写法是潜在的运行期崩溃。

修复

使用 comma-ok 断言先检查后使用，或用 type switch 分别处理各具体类型（注意 JSON 数字为 float64），并在无类型数据进入的边界处校验。

注意：把 JSON 数字直接转 int 会截断；精度敏感时应用带 UseNumber 的 json.Decoder 解码为有类型结构体。

func asInt(v any) (int, bool) {
	switch n := v.(type) {
	case int:
		return n, true
	case float64: // JSON numbers decode here
		return int(n), true
	case json.Number:
		i, err := n.Int64()
		return int(i), err == nil
	default:
		return 0, false
	}
}

if n, ok := asInt(raw); ok {
	fmt.Println(n)
}

验证

用类型不符的输入重跑，确认走防护分支而非 panic；为 string、int、float64 补充表驱动测试。

修复后补充一条回归测试，复现原始症状，防止问题再次出现。

这类故障通常是环境问题而非纯逻辑错误，因此在缺陷记录中应写明完整命令、环境变量与工作目录。请用最小的脚本复现，待最小用例清楚后再扩大范围。为这类故障准备一份简短的排查清单，能显著减少下次排障时间。