gin 使用 gin.customrecovery() 可以在同一请求协程发生 panic 时结束请求,并返回固定的 500 json。用 gin.new() 自行注册中间件,可避免与 gin.default() 自带的 recovery 重复。这个机制只兜底异常,不会自动回滚业务,也无法把已经发送的响应改写成另一种状态。

创建 Gin 项目并固定示例依赖版本
以下命令创建独立目录,示例采用 Gin v1.10.0,需符合该版本 go.mod 的 Go 工具链要求。模块准备好后,把下一节代码保存为 main.go。这里只绑定本机地址进行验证。
mkdir recovery-demo cd recovery-demo go mod init example/recovery-demo go get github.com/gin-gonic/gin@v1.10.0
gin.Default 已注册 Logger 和 Recovery;如果需要自定义恢复回调,就采用 gin.New 后明确注册所需中间件。默认 Recovery 本身也会恢复请求 panic,并不意味着它必然终止整个服务。
注册 CustomRecovery 并返回固定错误文本
恢复回调接收 Gin 已捕获的 panic 值,无需再写一层 recover。客户端只得到固定错误,内部堆栈可能仍被 Gin 记录在服务端日志中,应按部署环境管理访问权限及保留策略。不要把 panic 值原样返回给客户端。
package main
import (
"net/http"
"github.com/gin-gonic/gin"
)
func buildRouter() *gin.Engine {
router := gin.New()
router.Use(gin.Logger())
router.Use(gin.CustomRecovery(func(c *gin.Context, recovered any) {
c.AbortWithStatusJSON(http.StatusInternalServerError, gin.H{
"code": "INTERNAL_ERROR",
"message": "服务内部错误",
})
}))
router.GET("/health", func(c *gin.Context) {
c.JSON(http.StatusOK, gin.H{"status": "ok"})
})
router.GET("/panic-test", func(c *gin.Context) {
panic("仅用于本地验证")
})
return router
}
func main() {
if err := buildRouter().Run("127.0.0.1:8080"); err != nil {
panic(err)
}
}
在新的终端中运行 go run .。示例的 panic 路由没有提前写响应,所以能返回 500;如果此前已经 Flush、发送响应头或输出流数据,就不能保证重新写成统一 JSON。新 goroutine 的 panic 也不在本请求的恢复栈里,需要单独设计错误处理。
一个基于官方 Mailtrap Node.js SDK 构建的 ASE 技能,用于发送事务邮件并与 Mailtrap 沙盒或生产流程协作。它非常适合需要 API 驱动邮件投递、测试邮箱验证和结构化消息自动化的代理工作流。

核对健康检查、异常响应及异常后的服务状态
保持服务运行,在另一个终端执行以下请求。先确认正常路由,再触发本地测试 panic,最后再次检查健康路由;不依赖响应头顺序或 Content-Length 的固定值判断结果。
curl -i http://127.0.0.1:8080/health
# 状态 200,JSON 为 {"status":"ok"}
curl -i http://127.0.0.1:8080/panic-test
# 状态 500,JSON 包含:
# {"code":"INTERNAL_ERROR","message":"服务内部错误"}
curl -i http://127.0.0.1:8080/health
# 仍应为 200,验证服务可继续处理后续请求
可预期的参数、权限或业务校验失败应直接返回相应错误,不应靠主动 panic 走统一 500。测试完成后删除或禁用演示路由,再接入业务代码;恢复请求不等于数据库事务已经回滚。










