Go语言Windows NT服务场景下如何捕获第三方库抛出的panic

首先澄清普遍存在的误区：recover() 可以捕获同一 goroutine 内抛出的所有 panic，无论 panic 来自自有代码还是第三方依赖。绝大多数场景下无法捕获第三方库 panic 的原因是：第三方库内部启动了独立的新 goroutine，且没有在该 goroutine 入口处添加 defer recover() 逻辑。

方案1：代码层全局捕获 panic（优先推荐） #

通过统一封装 goroutine 启动逻辑，实现全链路 panic 捕获：

• 在主 goroutine 入口第一行添加 defer recover() 逻辑
• 所有你显式启动的 goroutine，统一使用带 recover 逻辑的封装函数启动
• 对于开源第三方依赖，可以直接修改其 goroutine 入口补全 recover 逻辑；闭源依赖则配合下方兜底方案处理

封装示例代码：

import (
	"fmt"
	"log"
	"os"
	"runtime/debug"
	"golang.org/x/sys/windows/svc/eventlog"
)

func GoWithRecover(fn func()) {
	go func() {
		defer func() {
			if r := recover(); r != nil {
				// 捕获panic信息与堆栈
				panicInfo := fmt.Sprintf("panic captured: %v\nstack trace:\n%s", r, debug.Stack())
				// 1. 写入本地日志文件
				log.Println(panicInfo)
				// 2. 同步到Windows事件查看器
				evl, err := eventlog.Open("你的服务注册名称")
				if err == nil {
					defer evl.Close()
					_ = evl.Error(1, panicInfo)
				}
				// 可根据业务需求选择是否终止进程
				os.Exit(1)
			}
		}()
		fn()
	}()
}

后续启动 goroutine 时统一调用 GoWithRecover(你的业务函数) 即可。

方案2：进程级 stderr 重定向（兜底方案） #

如果第三方库启动的 goroutine 无法添加 recover 逻辑，可以在程序启动时重定向整个进程的 stderr 输出，捕获所有 panic 日志：

• 可以直接重定向到本地日志文件，也可以通过管道实时读取 stderr 内容，匹配到 panic: 关键字时触发事件上报
  Windows 平台下 stderr 重定向示例：

import (
	"os"
	"syscall"
)

func RedirectStderr(logPath string) error {
	f, err := os.OpenFile(logPath, os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0644)
	if err != nil {
		return err
	}
	return syscall.Dup2(int(f.Fd()), int(os.Stderr.Fd()))
}

在 main 函数第一行调用该函数即可完成重定向。

方案3：外层包装捕获（无需修改Go代码） #

如果不想改动现有Go程序代码，可以通过服务包装层实现捕获：

• 不直接将Go程序注册为Windows服务，通过PowerShell/Bat脚本启动Go程序，将进程stderr输出重定向到日志，监听进程退出状态，若为异常退出则将日志同步到事件查看器
• 也可以使用成熟的Windows服务管理工具，配置异常捕获规则和日志上报规则。

同步到Windows事件查看器注意事项 #

• 需要提前以管理员权限注册事件源，执行命令：eventcreate /ID 1 /L APPLICATION /T ERROR /SO "你的服务名称" /D "服务事件源注册"
• 写入事件查看器的逻辑可以直接使用 golang.org/x/sys/windows/svc/eventlog 包实现，示例见方案1的代码片段。

内容的提问来源于stack exchange，提问作者ymerej