Logrus 不推荐作为微服务标准日志器，因其不原生支持上下文传播、trace_id/span_id注入及结构化输出，需中间件封装+request-scoped logger+定制JSONFormatter才能满足可观测性要求。
Logrus 在 Golang 微服务中能用，但不推荐作为“标准日志记录器”直接全局使用——它本身不带上下文传播、无结构化日志注入能力，且默认输出不兼容分布式追踪所需的 trace_id / span_id 字段。真要落地，必须补足中间层封装。
为什么直接 logrus.StandardLogger() 会破坏微服务可观测性
微服务里一条请求跨多个服务，日志必须携带 trace_id 和 span_id 才能串联；而原生 Logrus 不感知 HTTP 请求上下文，logrus.WithFields() 每次都要手动传，极易漏写或写错键名（比如写成 traceId 而非 trace_id）。更麻烦的是，它默认输出是 text 格式，K8s 日志采集器（如 Fluent Bit）解析困难，字段提取失败率高。
- 错误现象：
level=info msg="user created" user_id=123—— 没有trace_id，ELK 里查不到整条链路 - 常见误用：在 handler 里反复调用
logrus.WithFields(map[string]interface{}{"trace_id": tid})，结果某处忘了加，日志就断链 - 兼容性问题：Logrus v1.x 的
logrus.JSONFormatter输出时间是字符串，Prometheus + Loki 查询时无法按时间范围过滤
如何让 Logrus 支持 context-aware 日志输出
核心是把日志初始化和中间件绑定，让每次 HTTP 请求进来时自动注入 trace 上下文，并透传到所有子 goroutine。不能靠全局 logger，得靠 request-scoped logger 实例。
Colly 是一个用于 Go 语言的快速开源爬取和爬虫框架。它适用于从简单的页面提取到异步爬虫处理大量页面集合，支持请求回调和结构化解析。
- 用
middleware拦截请求，从X-Trace-ID或traceparentheader 提取trace_id，存入context.Context - 定义一个封装函数
NewRequestLogger(ctx context.Context)，内部调用logrus.WithFields()注入trace_id、span_id、service_name等固定字段 - handler 中用
log := logrus.WithContext(ctx)获取 logger，再调用log.Info("something")—— 这样logrus会自动合并 context 中的字段 - 注意：
logrus.WithContext()只对log.Info()类方法生效，logrus.Info()这种全局调用完全忽略 context
Logrus JSON 输出必须定制 logrus.Formatter
默认 logrus.JSONFormatter 时间字段是 string，且没有 caller 字段，调试时定位不到哪行代码打的日志。必须重写 formatter 或用社区方案。
立即学习“go语言免费学习笔记（深入）”；
- 推荐用
github.com/sirupsen/logrus/hooks/writer配合自定义JSONFormatter，把Time改成 UnixNano 整数，避免 JSON 解析失败 - 开启
logrus.SetReportCaller(true)后，需在 formatter 中显式读取entry.Caller并写入caller字段，否则 JSON 里看不到文件名和行号 - 关键配置项：
formatter.TimestampFormat = "2006-01-02T15:04:05.000Z"（ISO8601 毫秒级），否则 Grafana Loki 的 time parsing rule 会失效 - 别用
logrus.SetOutput(os.Stdout)直接输出，应包装为io.MultiWriter(os.Stdout, file)，方便同时输出到控制台和日志文件
替换 Logrus 的时机比你想象得更早
如果项目已接入 OpenTelemetry，或者计划用 Jaeger / Tempo 做追踪，Logrus 就不该是起点。它的 hook 机制在高并发下容易阻塞 goroutine（比如写文件 hook 没做 buffer），且不支持日志采样（sample logs to reduce volume）。
- 真正生产可用的替代方案是
go.uber.org/zap：启动快、内存零分配、自带zapcore.AddSync控制异步写入，且官方提供zap.RegisterSink接入 Kafka / Loki - 若必须用 Logrus，至少用
logrus.WithError(err).WithFields(...).Error()替代logrus.Error(err.Error())，否则 error stack trace 会丢失 - 最常被忽略的一点：Logrus 的 level 是全局设置的，
logrus.SetLevel(logrus.WarnLevel)会影响所有 logger 实例——微服务里不同模块需要不同日志等级时，必须用logrus.New()创建独立实例，而非复用 global logger
