Go 接口为什么看起来不是 nil

我第一次遇到这个问题是在一个函数返回 error 的场景：日志里明明打印出指针值是 ，调用方的 if err != nil 却进入了错误分支。这里不是 Go 把 nil 判错了，而是接口里还保存着一个具体类型。

判断标准可以先记成一句话：接口值只有“动态类型”和“动态值”都为空时才等于 nil。一个 nil 指针一旦装进接口，类型信息还在，所以接口本身通常不是 nil。

官方资料：https://go.dev/ref/spec#Interface_types　https://go.dev/blog/laws-of-reflection

为什么 nil 指针装进接口后会变成非 nil

先看最小配方。p 的底层指针值为空，但赋值给 any 后，接口还记住了动态类型 *User，因此比较结果为 false。

package main

import "fmt"

type User struct{}

func main() {
	var p *User = nil // 底层指针为空
	var v any = p     // 接口仍保存动态类型 *User

	fmt.Println(p == nil) // true：直接比较指针
	fmt.Println(v == nil) // false：接口还有具体类型
}

把接口想成一对信息会更容易排查：空接口是 (nil, nil)，而装入 nil 指针后接近 (*User, nil)。后者的值部分为空，类型部分不为空，所以接口仍然有内容。

返回 error 时，最小修复是直接返回 nil

这个坑最常见于自定义错误类型。*parseError 实现了 Error()，把它转换为 error 时会产生一个非 nil 接口。不要先声明一个 typed nil 再把它作为错误返回；没有错误时直接写裸的 return nil。

package main

import "fmt"

type parseError struct{ Field string }

func (e *parseError) Error() string {
	if e == nil { // 允许诊断代码安全打印 nil 接收者
		return "parse error"
	}
	return "invalid field: " + e.Field
}

func parse(ok bool) error {
	if !ok {
		return &parseError{Field: "name"} // 真有错误时返回具体错误
	}
	return nil // 没有错误时返回真正的 nil 接口
}

func main() {
	err := parse(true)
	fmt.Println(err == nil) // true
}

如果函数必须返回一个可能为空的指针，先在指针层面判断，再决定返回哪个接口值。不要用 fmt.Sprint、字符串比较或“打印出来像 nil”替代接口比较。

排查时先打印动态类型，不要急着上 reflect

现场定位时，%T 看动态类型，%#v 看带类型的 Go 表示。两者一起打印，通常已经能说明为什么日志像 nil 而判断不是 nil。

import "fmt"

func inspect(v any) {
	fmt.Printf("type=%T value=%#v isNil=%v\n", v, v, v == nil)
}

// 调用 inspect((*User)(nil)) 时，type 会显示 *main.User，isNil 会显示 false。

只有在通用容器、插件边界或反射框架中确实需要识别“可为 nil 的底层值”时，才使用 reflect。Value.IsNil 只接受指针、切片、映射、函数、通道或接口等特定 Kind；拿到结构体或整数直接调用会触发 panic。

import "reflect"

func isNilLike(v any) bool {
	if v == nil {
		return true // 先处理空接口
	}
	rv := reflect.ValueOf(v)
	switch rv.Kind() {
	case reflect.Chan, reflect.Func, reflect.Map, reflect.Pointer, reflect.Slice:
		return rv.IsNil() // 只有可为空的 Kind 才能调用 IsNil
	default:
		return false // 结构体、数字等没有 nil 状态
	}
}

记住这三个接口 nil 复查点

• 直接比较指针、切片或 map 时，先确认比较对象是不是接口。
• 返回 error 时，无错误分支使用裸 return nil，不要返回 typed nil。
• 遇到日志与判断矛盾，先看 %T 和 %#v；reflect 只放在确有通用需求的边界。

相关问题：为什么 error 接口里的 nil 指针仍会进入错误分支？如何区分 nil slice 和空 slice？什么时候应该用 errors.As 而不是反射？