本文介绍两种可靠方式，将 go 程序中 panic 触发的完整堆栈跟踪（stack trace）默认输出到自定义日志文件，而非仅显示在终端，从而确保服务端部署时关键错误信息不丢失。
本文介绍两种可靠方式，将 go 程序中 panic 触发的完整堆栈跟踪（stack trace）默认输出到自定义日志文件，而非仅显示在终端，从而确保服务端部署时关键错误信息不丢失。
在 Go 中，panic 发生时默认会将堆栈跟踪打印到标准错误（os.Stderr），而该输出通常直接显示在控制台——这对本地开发调试尚可，但在无终端交互的服务器环境中（如 systemd 服务、Docker 容器或后台进程），这些关键诊断信息极易丢失。你已通过 log.New() 构建了带时间戳和文件位置的结构化日志器（Info），但该日志器不会自动捕获 panic 输出。要实现“panic 堆栈自动落盘”，需主动接管标准错误流或拦截 panic 事件。
✅ 方案一：重定向 stderr 到日志文件（推荐用于全局兜底）
使用 syscall.Dup2 将打开的日志文件描述符复制为标准错误（文件描述符 2），使所有未显式处理的 panic、log.Fatalln、fmt.Fprintln(os.Stderr, ...) 等输出均写入目标文件：
package main
import (
"fmt"
"log"
"os"
"syscall"
)
var (
logFile *os.File
Info *log.Logger
)
func init() {
var err error
logFile, err = os.OpenFile("/my/file/with.log", os.O_CREATE|os.O_APPEND|os.O_WRONLY, 0666)
if err != nil {
fmt.Printf("Cannot open log file: %s. Program terminated.", err)
os.Exit(1)
}
Info = log.New(logFile, "INFO: ", log.Ldate|log.Ltime|log.Lshortfile)
}
func main() {
// 关键：将 logFile 的 fd 复制为 stderr (fd=2)
if err := syscall.Dup2(int(logFile.Fd()), 2); err != nil {
log.Printf("Failed to redirect stderr: %v", err)
}
// 示例：触发 panic 查看效果
panic("test panic with full stack trace")
}⚠️ 注意事项：
- 此方法需在
main()开始时尽早调用（早于任何可能触发 panic 的逻辑）；syscall.Dup2是 Unix/Linux/macOS 兼容方案；若需 Windows 支持，请改用os.Stderr = logFile（Go 1.16+ 更安全）：os.Stderr = logFile // 替代 syscall.Dup2，跨平台且简洁
✅ 方案二：使用 recover 自定义 panic 处理（推荐用于精细化控制）
通过 defer + recover 拦截 panic，手动获取并格式化堆栈，再写入你的 Info 日志器。此方式更可控，可添加上下文、过滤敏感信息或集成 Sentry 等监控：
import (
"bytes"
"debug/stack"
"log"
"runtime/debug"
)
func main() {
defer func() {
if r := recover(); r != nil {
// 获取原始 panic 值与完整堆栈
var buf bytes.Buffer
buf.WriteString("PANIC RECOVERED:\n")
buf.WriteString(fmt.Sprintf("%v\n", r))
buf.Write(debug.Stack()) // 包含 goroutine 信息和完整调用链
// 写入自定义日志器（带 INFO 前缀 + 时间戳）
Info.Println(buf.String())
// 可选：重新 panic 以保留原有退出行为（如需）
// panic(r)
}
}()
panic("intentional panic for testing")
}? 提示：
debug.Stack()返回的是当前 goroutine 的堆栈；若需更详细的多 goroutine 快照，可用pprof.Lookup("goroutine").WriteTo(&buf, 2)（需导入net/http/pprof）。
总结建议
-
生产环境首选方案一（
os.Stderr = logFile）：简单、可靠、零侵入，确保所有未捕获错误（包括第三方库 panic）均落盘； - 需要定制化处理（如分级告警、上下文注入、错误归类）时选用方案二；
- 切勿混合使用两种方案，避免日志重复或竞态；
- 记得在程序退出前关闭
logFile（defer logFile.Close()），防止日志缓冲区丢失最后几行。
至此，你的 Go 服务即可在服务器静默运行时，完整留存每一次崩溃的诊断证据——让故障排查从“猜”变为“查”。
