Iris框架API日志记录的配置技巧-Golang-PHP中文网

启用Iris内置请求日志中间件需调用app.Use(iris.Logger)，且必须置于所有路由注册之前；它线程安全、自动记录方法、路径、状态码、时长和字节数，但不支持自定义格式或输出目标。

iris框架api日志记录的配置技巧

如何启用Iris内置请求日志中间件

Iris自带iris.Logger中间件，开箱即用，但默认不启用。它比手写fmt.Printf更可靠，能自动记录方法、路径、状态码、响应时长和字节数，且线程安全。

直接在app.Use(iris.Logger)后调用即可，注意它必须放在所有路由注册之前（否则部分请求可能漏记），但可放在app.Use()链的任意位置——它不改变流程，只追加日志。

别把它塞进某个Party里，除非你只想记录子路径；全局日志就该挂到根app
若同时用了自定义日志中间件（如写文件），iris.Logger的输出会混在其中，建议二选一，避免重复
本地开发可放心用，生产环境若QPS高，需确认日志IO是否成瓶颈；此时可考虑异步写或降级为采样日志

自定义日志格式与输出目标

iris.Logger默认输出到os.Stdout，格式固定。如需写入文件、添加traceID或调整字段顺序，得自己实现一个中间件，核心是读取ctx.Recorder().StatusCode()、ctx.Recorder().BodyLength()和ctx.GetDuration()。

关键点：必须在ctx.Next()之后读取响应信息，否则StatusCode()还是0，BodyLength()为-1。

示例片段：

func customLogger() iris.Handler {
	return func(ctx iris.Context) {
		start := time.Now()
		ctx.Next() // 必须先放行
		status := ctx.Recorder().StatusCode()
		bodyLen := ctx.Recorder().BodyLength()
		duration := time.Since(start).Microseconds()
		log.Printf("[%s] %s %s %d %dμs %d", 
			time.Now().Format("2006-01-02T15:04:05"), 
			ctx.Method(), ctx.Path(), status, duration, bodyLen)
	}
}

别用ctx.Request().URL.String()取完整URL——它不含Host，且query参数未标准化；用ctx.FullRequestURI()更准
如果用了ctx.StopExecution()（如OPTIONS预检），BodyLength()恒为0，但StatusCode()仍有效

过滤日志：跳过健康检查与静态资源

全量记录会导致日志爆炸，尤其/health、/metrics、/favicon.ico这类高频请求。Iris不提供内置白名单，必须在中间件内手动判断并跳过。

Iris框架 12.2.5

Iris框架 12.2.5 版本源码包下载，适合需要 MVC Singleton 控制器、依赖注入字段控制和 debug 错误日志改进的开发者。

下载

重点不是“不记录”，而是“不打日志但继续执行”——所以不能return，而要调ctx.Next()后直接返回。

路径判断用ctx.Path()，不是ctx.Request().URL.Path；前者已去除查询参数且标准化，后者可能含未解码字符
常见漏判：/healthz、/readyz、/ping，建议用strings.HasPrefix(ctx.Path(), "/health") || ctx.Path() == "/ping"覆盖
静态资源如/static/或/assets/，若用app.HandleDir托管，其请求也会进中间件，需一并过滤