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 值原样返回给客户端。
一个基于官方 Mailtrap Node.js SDK 构建的 ASE 技能,用于发送事务邮件并与 Mailtrap 沙盒或生产流程协作。它非常适合需要 API 驱动邮件投递、测试邮箱验证和结构化消息自动化的代理工作流。
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 也不在本请求的恢复栈里,需要单独设计错误处理。

核对健康检查、异常响应及异常后的服务状态
保持服务运行,在另一个终端执行以下请求。先确认正常路由,再触发本地测试 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。测试完成后删除或禁用演示路由,再接入业务代码;恢复请求不等于数据库事务已经回滚。

















