在Golang程序运行中，除了通过函数返回值显式传递的错误外，还会存在各类未知错误，比如数组越界、空指针解引用、主动触发的panic等，这类错误如果没有被正确处理，会直接导致程序崩溃退出。掌握未知错误的捕获方法，是提升Golang程序稳定性的重要手段。
什么是Golang中的未知错误
Golang中的错误分为两种类型，一种是显式错误，也就是函数通过返回error类型值传递的错误，开发者可以主动判断处理。另一种是未知错误，这类错误通常不是通过正常错误返回流程产生，而是运行时的异常行为，最常见的表现就是panic。
未知错误常见的触发场景包括：
- 访问越界的数组或切片元素
- 对nil指针进行解引用操作
- 调用panic函数主动触发异常
- 并发场景下未处理的goroutine异常
捕获未知错误的核心工具recover
Golang内置了recover函数用于捕获panic产生的未知错误，它的使用有严格的规则：只能在defer调用的函数中使用，并且只有在发生panic之后调用才能生效，返回值是panic传递的参数。
基础使用示例
下面是一个简单的未知错误捕获示例，当程序触发panic时，通过recover捕获错误避免程序崩溃：
package main
import "fmt"
func main() {
// 注册defer函数用于捕获未知错误
defer func() {
// 调用recover捕获panic
if err := recover(); err != nil {
fmt.Printf("捕获到未知错误: %vn", err)
}
}()
// 主动触发panic，模拟未知错误
panic("模拟未知的运行时错误")
// 下面的代码不会执行
fmt.Println("这行代码不会输出")
}
recover的使用注意事项
使用recover时需要注意以下几点：
- recover必须放在defer修饰的函数中，否则无法捕获panic
- 如果没有发生panic，recover的返回值是nil
- recover只能捕获当前goroutine中的panic，其他goroutine的panic无法跨goroutine捕获
- 捕获到未知错误后，程序会从panic点之后的defer逻辑继续执行，不会回到panic点继续执行原有代码
goroutine中的未知错误捕获
由于recover只能捕获当前goroutine的panic，因此在新启动的goroutine中，也需要单独设置defer和recover逻辑，否则该goroutine的panic会导致整个程序崩溃。
下面是goroutine中捕获未知错误的示例：
package main
import (
"fmt"
"time"
)
func worker() {
// 每个goroutine单独设置defer捕获逻辑
defer func() {
if err := recover(); err != nil {
fmt.Printf("worker goroutine捕获到未知错误: %vn", err)
}
}()
// 模拟goroutine中的未知错误
time.Sleep(time.Second)
panic("worker内部发生未知错误")
}
func main() {
// 启动新的goroutine
go worker()
// 主goroutine等待，避免程序提前退出
time.Sleep(2 * time.Second)
fmt.Println("主程序正常结束")
}
未知错误捕获后的处理实践
捕获到未知错误之后，不能仅仅打印错误就结束，需要根据业务场景做合理的处理：
- 记录详细的错误堆栈信息，方便后续排查问题，可以使用
runtime/debug包的Stack函数获取堆栈 - 根据错误的严重程度决定处理方式，比如非核心逻辑的错误可以记录后忽略，核心逻辑的错误可能需要触发告警或者优雅退出
- 避免捕获到错误后不做任何处理直接忽略，导致隐藏的业务问题无法被发现
下面是一个包含堆栈记录的未知错误处理示例：
package main
import (
"fmt"
"runtime/debug"
)
func main() {
defer func() {
if err := recover(); err != nil {
// 打印错误信息和堆栈
fmt.Printf("捕获未知错误: %vn", err)
fmt.Printf("错误堆栈:n%sn", debug.Stack())
}
}()
// 触发数组越界错误，模拟未知错误
var arr []int
_ = arr[1]
}
常见问题说明
很多开发者会误以为在main函数设置了recover就能捕获所有goroutine的错误，这是不正确的。每个goroutine都有独立的执行栈，panic只会沿着当前goroutine的调用栈向上传递，因此每个新启动的goroutine都需要单独设置错误捕获逻辑。
另外，recover不能捕获编译错误或者运行时之前的错误，比如语法错误、导入包不存在这类问题，只能在程序运行时的panic场景中生效。
Golangunknown_error_capturerecoverpanicerror_handling修改时间：2026-07-01 16:45:30