在Go语言的函数设计中，当函数需要返回结构体类型的结果时，错误处理的方式会直接影响代码的健壮性和可读性，很多开发者都曾因为错误的返回模式踩过空指针或者逻辑失效的坑。
常见的错误返回误区
误区一：先返回结构体再处理错误
很多开发者会写出类似下面的代码：
func GetUser() (User, error) {
// 模拟查询失败场景
return User{}, errors.New("query user failed")
}
type User struct {
ID int
Name string
}
func main() {
user, err := GetUser()
if err != nil {
fmt.Println("get user error:", err)
// 此时user是零值，如果后续直接使用user的字段会出现逻辑问题
return
}
fmt.Println(user.Name)
}
这种写法的问题在于，当错误发生时返回的结构体是零值，如果调用方忘记判断错误就直接使用结构体，很容易引发不符合预期的逻辑。更糟糕的情况是，如果结构体包含指针字段，错误时返回的指针可能是nil，直接访问会触发panic。
误区二：把错误嵌入结构体中返回
有些开发者会把错误作为结构体的一个字段，这种设计不符合Go的错误处理惯例：
type User struct {
ID int
Name string
Err error
}
func GetUser() User {
return User{Err: errors.New("query failed")}
}
这种方式的弊端是调用方很容易忽略结构体内的错误字段，而且破坏了Go语言通过返回值显式传递错误的设计理念，后续维护时也很难快速定位错误处理逻辑。
正确的处理实践
实践一：错误和结构体分开返回，优先判断错误
这是Go语言最标准的做法，函数同时返回结构体和error类型，调用方必须先判断error是否为nil再使用结构体：
import (
"errors"
"fmt"
)
type User struct {
ID int
Name string
}
// 正确做法：结构体作为第一个返回值，error作为第二个返回值
func GetUser(id int) (User, error) {
if id <= 0 {
return User{}, errors.New("invalid user id")
}
// 模拟正常查询
return User{ID: id, Name: "test"}, nil
}
func main() {
user, err := GetUser(1)
// 优先判断错误，错误不为nil时不使用结构体
if err != nil {
fmt.Println("get user failed:", err)
return
}
fmt.Printf("user id: %d, name: %sn", user.ID, user.Name)
}
这种方式的优势是符合Go的惯用法，调用方一眼就能明确需要处理错误，而且错误发生时返回的结构体零值不会被误使用，只要调用方遵循先判错再使用的规则，就能规避大部分问题。
实践二：返回结构体指针时的注意事项
如果函数返回的是结构体指针，错误发生时建议返回nil指针，同时配合错误信息：
import (
"errors"
"fmt"
)
type User struct {
ID int
Name string
}
func GetUserPointer(id int) (*User, error) {
if id <= 0 {
// 错误时返回nil指针和错误信息
return nil, errors.New("invalid user id")
}
return &User{ID: id, Name: "test"}, nil
}
func main() {
userPtr, err := GetUserPointer(1)
if err != nil {
fmt.Println("get user failed:", err)
return
}
// 此时userPtr一定不为nil，可以安全访问
fmt.Printf("user id: %d, name: %sn", userPtr.ID, userPtr.Name)
}
这里要注意，不要返回指向零值结构体的指针，因为调用方可能会忽略错误直接判断指针是否为nil，返回零值指针会让这种判断失效，返回nil指针能让错误状态更明确。
实践三：多结构体返回时的错误统一处理
如果函数需要返回多个结构体，同样遵循错误最后返回的原则，所有结构体都放在错误返回值之前：
import (
"errors"
"fmt"
)
type User struct {
ID int
Name string
}
type Order struct {
ID int
UserID int
Amount float64
}
func GetUserAndOrder(uid int, oid int) (User, Order, error) {
if uid <= 0 || oid <= 0 {
return User{}, Order{}, errors.New("invalid param")
}
// 模拟查询逻辑
user := User{ID: uid, Name: "test"}
order := Order{ID: oid, UserID: uid, Amount: 100.0}
return user, order, nil
}
func main() {
user, order, err := GetUserAndOrder(1, 1)
if err != nil {
fmt.Println("get data failed:", err)
return
}
fmt.Printf("user: %v, order: %vn", user, order)
}
不同场景的选择建议
可以根据实际场景选择合适的返回方式：
- 如果函数返回的结构体是值类型，且零值有明确的业务含义，需要在文档中说明零值的含义，同时提醒调用方优先判断错误
- 如果结构体包含必须初始化的指针字段，建议返回指针类型，错误时返回nil，避免调用方拿到不可用的指针
- 如果错误场景非常多，且结构体的零值无法区分是否有错误，不要尝试把错误信息嵌入结构体，保持错误作为独立返回值的设计
总结
Go语言中返回结构体时的错误处理核心原则是：错误作为独立的返回值放在所有结构体返回值之后，错误发生时返回结构体零值（指针类型返回nil），调用方必须先判断错误再使用结构体。这种设计符合Go的显式错误处理理念，能让代码的错误处理逻辑更清晰，减少运行时问题的发生。
Go错误处理结构体返回error_interface函数设计修改时间：2026-06-16 16:21:39