Go语言如何通过重定向os.Stderr禁用第三方库日志

Go 生态中绝大多数未做特殊配置的第三方库，默认都会将日志输出到os.Stderr，不需要修改第三方库源码、也不需要改动现有自定义日志包，通过替换os.Stderr为管道入口、异步读取过滤日志内容的方式即可实现拦截，具体操作如下：

核心实现逻辑 #

os.Stderr本身是*os.File类型，无法直接赋值自定义的io.Writer实现，需要借助操作系统管道完成转发：

1. 提前保存原始的os.Stderr句柄，留给自己的自定义日志包使用，避免自身日志被拦截
2. 创建OS管道，将管道写端替换为全局的os.Stderr，此后所有写入stderr的内容都会进入管道
3. 启动常驻协程读取管道读端的内容，按自定义规则丢弃、过滤或转发到自有日志系统

可直接运行的代码示例 #

package main

import (
	"io"
	"os"
	"strings"
	// 替换为你自己的自定义日志包导入路径
	// "your/project/mylog"
)

func init() {
	// 如果要拦截第三方库在init阶段输出的日志，把这段逻辑放在init最开头，且保证当前包是main包第一个导入的包
	// 1. 保存原始stderr句柄，供自有日志使用
	origStderr := os.Stderr
	// 如果你的自定义日志包支持设置输出，在此处将其输出指向原始stderr即可，无需修改日志包源码
	// 例：mylog.SetOutput(origStderr)

	// 2. 创建管道
	pipeReader, pipeWriter, err := os.Pipe()
	if err != nil {
		panic("init log interceptor failed: " + err.Error())
	}
	// 3. 替换全局stderr为管道写端
	os.Stderr = pipeWriter

	// 4. 启动协程异步处理拦截到的日志
	go func() {
		buf := make([]byte, 4096) // 4k缓冲区足够覆盖绝大多数单行日志
		for {
			n, readErr := pipeReader.Read(buf)
			if n > 0 {
				logContent := buf[:n]
				logStr := string(logContent)

				// --------------------------
				// 在这里自定义你的处理规则
				// --------------------------
				// 规则1：直接丢弃所有拦截到的日志，什么都不写即可
				// continue

				// 规则2：按关键字过滤，匹配到第三方库特征的日志丢弃，其余输出到原始stderr
				if strings.HasPrefix(logStr, "[your-third-party-lib]") {
					continue
				}
				_, _ = origStderr.Write(logContent)

				// 规则3：将拦截到的日志转发到自有日志系统
				// mylog.Debug("captured log: %s", logStr)
			}

			if readErr != nil {
				if readErr == io.EOF {
					return
				}
				// 读异常直接退出协程，不影响主业务运行
				return
			}
		}
	}()
}

func main() {
	// 后续正常写业务逻辑、初始化第三方库即可
}

注意事项 #

• 拦截逻辑的执行时机要尽可能早：如果第三方库在init()阶段就会输出日志，需要把拦截逻辑放到独立包的init()中，并且保证该包在main包的导入列表中排在第一位，确保它的init执行顺序早于其他第三方库
• 不要关闭创建的管道读写端，否则会导致日志写入触发panic
• 如果不需要做复杂过滤，只想完全屏蔽所有第三方库的stderr输出，直接在协程读到日志内容后不做任何处理即可，所有日志会被直接丢弃，不会输出到终端
• 该方案对所有直接写入os.Stderr文件描述符的日志库都生效，不需要适配各类第三方日志实现

内容的提问来源于stack exchange，提问作者Raphael Khaykin