Go interface nil 装着 nil 指针为什么不等于 nil

排查 Go 错误处理时，经常会遇到这样的输出：指针变量明明是 nil，把它作为 error 返回后，调用方的 err == nil 却是 false。原因不是 Go 把比较结果算错了，而是接口里还保留着动态类型。只有动态类型和值同时为空，接口值才是真正的 nil。

先复现：指针是 nil，接口为什么不是

把下面的例子放在一个最小 Go 文件中运行，关键是观察同一个 nil 经过赋值前后的类型变化：

package main

import "fmt"

type MyError struct{}

func (e *MyError) Error() string {
	// 方法允许在接收者为 nil 时被调用，但业务代码仍应明确这个边界。
	return "业务错误"
}

func main() {
	var p *MyError
	var err error = p

	fmt.Println(p == nil)       // true：p 的静态类型是 *MyError
	fmt.Println(err == nil)     // false：err 仍携带动态类型 *MyError
	fmt.Printf("%T\n", err)     // *main.MyError：类型信息没有消失
}

赋值给 err 的瞬间，接口不再是“没有内容”的状态，而是类似 (动态类型=*MyError, 动态值=nil)。因此比较时，err 与真正的空接口 (nil, nil) 并不相等。

接口比较的关键是类型和值两层

可以把接口值理解成两层盒子：外层记录接口本身，内层记录具体动态类型和动态值。直接声明的 var x any 两层都空；而 var p *MyError 再赋给接口，只把值置空，类型仍然存在。

这也解释了为什么接口类型可以在运行时容纳不同具体类型。Go 规范把接口变量的动态类型定义为运行时赋入值的非接口类型；比较两个接口时，动态类型必须一致且动态值相等，或者两者都是真正的 nil。

error 返回值要在接口层面结束 nil

最容易出错的地方是返回具体指针类型，再隐式转换为 error。成功分支不要返回一个 typed nil：

type ParseError struct{ Field string }

func (e *ParseError) Error() string {
	// 这里只返回固定信息，避免示例把 nil 接收者解引用。
	return "字段解析失败"
}

func parse(input string) error {
	if input == "" {
		// 失败时返回具体错误，接口动态类型是 *ParseError。
		return &ParseError{Field: "input"}
	}
	// 成功时直接返回接口层面的 nil，不要 return (*ParseError)(nil)。
	return nil
}

调用方只需要判断 if err != nil。如果函数内部先声明 var e *ParseError，最后写 return e，就会把类型带进接口，形成本文的陷阱。

必须兼容 typed nil 时怎么判断

有些旧接口、插件回调或泛型边界确实可能收到 typed nil。这时不要把所有接口都交给反射。已知类型优先使用类型断言，让判断和后续处理保持同一条路径：

func isNilParseError(v error) bool {
	// 断言成功说明动态类型确实是 *ParseError，再判断具体指针值。
	e, ok := v.(*ParseError)
	return ok && e == nil
}

只有在通用库无法预先知道具体类型时，才考虑 reflect.ValueOf，并且先判断 IsValid，再确认类型属于指针、切片、映射、函数、接口或通道等可为 nil 的种类。反射写法更长，也更容易把“接口为空”和“具体值为空”混为一谈。

代码评审时记住四个检查点

看到接口 nil 问题，可以沿着赋值链回看：第一，返回签名是否是接口；第二，是否把具体 nil 指针直接 return；第三，比较发生前是否经过了接口赋值；第四，接口里的具体类型是否真的允许 nil。修复通常只需要把成功分支改成接口层面的 return nil，而不是增加一层不透明的反射判断。

常见问题

接口里放 nil slice 也会出现同样问题吗？

会。nil slice 作为接口动态值保存时，接口仍有 slice 类型，因此接口本身不等于 nil；要判断 slice 内容需先断言到具体类型。

为什么 fmt.Println 看起来像 nil？

打印通常展示动态值的表现形式，未必展示接口携带的动态类型。调试时同时打印 %T 和与 nil 的比较结果。

是不是所有 Error 方法都不能用 nil 接收者？

不是。方法是否能处理 nil 接收者取决于实现；但能调用不代表接口比较会变成 nil，返回值设计仍应避免 typed nil。