Kratos 请求日志通过 logging.Server 中间件实现,需显式传入 http.Middleware 或 grpc.Middleware 包裹;它不自动注入 trace_id 等上下文字段,也不默认脱敏敏感信息,须手动配置 logger.With 和 log.Filter。

HTTP 服务启用 logging.Server 中间件
Kratos 的请求日志不是靠修改 Logger 实现,而是通过 logging.Server 中间件自动注入。它会拦截每个 HTTP 请求,在进入业务 handler 前/后打印结构化日志,包含 method、path、status、cost、user-agent 等字段。
关键点:必须在 http.NewServer 的 http.ServerOption 中显式传入,不能只配 logger 或只写中间件函数。
- 正确写法:
logger := log.DefaultLogger srv := http.NewServer( http.Middleware(logging.Server(logger)), ) - 错误写法:漏掉
http.Middleware(...)包裹,或把logging.Server当成普通函数直接调用 - 注意:该中间件默认不采集请求 body 和响应 body,避免敏感数据泄露或性能损耗;如需 body 日志,得自行扩展或改用自定义中间件
gRPC 服务启用 logging.Server 中间件
gRPC 请求日志逻辑与 HTTP 类似,但中间件名相同、用法不同——要放在 grpc.ServerOption 里,且依赖 grpc.Middleware 包裹。
常见陷阱是混用 HTTP 和 gRPC 的中间件类型,导致编译失败或静默不生效。
- 正确写法:
logger := log.DefaultLogger srv := grpc.NewServer( grpc.Middleware(logging.Server(logger)), ) -
logging.Server在 gRPC 场景下只打印 trace_id、method、code、cost,不打印 request/response 原始结构体(避免 protobuf 序列化开销) - 若需完整 request/response 内容,应结合
log.With+log.Helper在业务 handler 内手动打点,而非强求中间件
日志字段缺失或格式错乱?检查 logger 是否带 Valuer
默认 logging.Server 打印的字段是固定的,但像 trace_id、span_id 这类上下文字段不会自动出现,除非你提前把它们注入 logger。
原因在于中间件内部调用的是 logger.Log(),而它只负责把预设字段塞进 keyvals,不主动调用 Valuer。
- 必须在创建 logger 时用
log.With绑定:logger = log.With(log.DefaultLogger, "trace_id", tracing.TraceID(), "span_id", tracing.SpanID(), "service.name", "user", ) h := log.NewHelper(logger) // 再传给 logging.Server(h) —— 注意传 Helper 也可,但字段必须已注入 - Valuer 函数(如
tracing.TraceID())必须返回可序列化值,否则日志输出为或 panic - 不要在每次请求中重复
log.With,那会创建大量临时 logger 对象,应复用带全局 Valuer 的 logger 实例
想过滤或脱敏请求日志中的敏感字段?用 Filter 链
logging.Server 输出的日志仍走标准 logger 流程,所以所有 Filter 规则都适用。比如想隐藏 Authorization header 或 password 字段,不用改中间件源码,只需包装 logger。
Filter 是链式执行的,顺序影响结果:脱敏应在格式化前,否则可能匹配不到原始 key。
- 示例(屏蔽 header 中的 token):
filteredLogger := log.NewFilter(log.DefaultLogger, log.FilterKey("authorization"), log.FilterKey("x-api-key"), ) srv := http.NewServer(http.Middleware(logging.Server(filteredLogger))) -
log.FilterKey会把对应 key 的 value 替换为"***";log.FilterValue则匹配 value 内容(慎用,可能误伤) - 多个 Filter 可叠加,但注意性能:每条日志都会依次经过全部 Filter,敏感字段多时建议合并逻辑或用正则优化
Kratos 的请求日志机制本质是“中间件 + 统一日志接口”的组合,真正容易被忽略的是:它不自动继承上下文 Valuer,也不默认做脱敏——这两件事必须由你显式配置 logger 实例,而不是寄希望于中间件自己处理。











