在Golang的测试场景中，捕获日志输出是验证程序运行逻辑的重要手段，尤其是当我们需要确认特定条件下是否输出了预期的日志内容时，直接捕获日志比修改业务代码适配测试要更合理。Golang的标准库log默认将日志输出到标准错误流，我们可以通过调整输出目标、替换输出流等方式实现日志捕获。
方法一：替换标准log的输出目标
标准库的log包提供了SetOutput方法，可以临时将日志输出目标替换为我们自定义的写入器，测试完成后再恢复原来的输出目标即可。这种方式适合使用标准log库输出日志的场景。
实现步骤
- 创建一个缓冲区作为临时的日志输出目标
- 调用
log.SetOutput将输出指向缓冲区 - 执行需要测试的业务逻辑
- 从缓冲区中读取日志内容进行断言
- 测试结束后恢复原来的输出目标
代码示例
package main
import (
"bytes"
"log"
"testing"
)
// 待测试的业务函数，使用标准log输出日志
func businessFunc() {
log.Println("业务执行开始")
log.Println("业务执行完成")
}
func TestCaptureLog(t *testing.T) {
// 保存原来的输出目标，测试结束后恢复
oldOutput := log.Writer()
defer log.SetOutput(oldOutput)
// 创建缓冲区作为临时输出目标
buf := new(bytes.Buffer)
log.SetOutput(buf)
// 执行业务逻辑
businessFunc()
// 获取捕获的日志内容
logContent := buf.String()
// 断言日志包含预期内容
if !bytes.Contains(buf.Bytes(), []byte("业务执行开始")) {
t.Errorf("日志未包含预期内容，实际日志: %s", logContent)
}
}
方法二：捕获自定义日志库的日志输出
如果项目中使用了自定义的日志库，或者使用了像logrus、zap这类第三方日志库，我们可以通过替换日志库的输出钩子或者输出目标来实现捕获。以常用的logrus为例，我们可以通过添加钩子将日志写入缓冲区。
代码示例
package main
import (
"bytes"
"testing"
"github.com/sirupsen/logrus"
)
// 待测试的业务函数，使用logrus输出日志
func businessFuncWithLogrus() {
logrus.Info("logrus业务执行开始")
logrus.Info("logrus业务执行完成")
}
func TestCaptureLogrusLog(t *testing.T) {
// 创建缓冲区
buf := new(bytes.Buffer)
// 创建新的logrus实例，避免影响全局配置
logger := logrus.New()
// 设置输出到缓冲区
logger.SetOutput(buf)
// 设置日志格式为文本格式，方便断言
logger.SetFormatter(&logrus.TextFormatter{
DisableTimestamp: true,
})
// 调用业务逻辑时传入自定义logger，或者替换全局logger
// 这里演示替换全局logger的方式，实际项目中更推荐依赖注入
oldLogger := logrus.StandardLogger()
logrus.SetOutput(buf)
defer logrus.SetOutput(oldLogger.Writer())
businessFuncWithLogrus()
logContent := buf.String()
if !bytes.Contains(buf.Bytes(), []byte("logrus业务执行开始")) {
t.Errorf("日志未包含预期内容，实际日志: %s", logContent)
}
}
方法三：捕获标准输出和标准错误流
如果日志是直接通过fmt.Println输出到标准输出，或者输出到标准错误流，我们可以通过临时替换os.Stdout和os.Stderr来实现捕获。这种方式需要注意文件描述符的替换和恢复，避免影响其他测试。
代码示例
package main
import (
"bytes"
"fmt"
"os"
"testing"
)
// 待测试的函数，直接输出到标准输出
func printToStdout() {
fmt.Println("标准输出内容")
}
func TestCaptureStdout(t *testing.T) {
// 保存原来的标准输出
oldStdout := os.Stdout
// 创建管道用于捕获输出
r, w, _ := os.Pipe()
// 替换标准输出为管道的写入端
os.Stdout = w
// 执行输出逻辑
printToStdout()
// 关闭写入端，确保数据全部写入管道
w.Close()
// 恢复原来的标准输出
os.Stdout = oldStdout
// 从管道读取端读取捕获的内容
buf := new(bytes.Buffer)
buf.ReadFrom(r)
logContent := buf.String()
if !bytes.Contains(buf.Bytes(), []byte("标准输出内容")) {
t.Errorf("标准输出未包含预期内容，实际输出: %s", logContent)
}
}
注意事项
- 测试过程中替换全局输出目标时，一定要在测试结束后恢复原来的配置，避免影响其他测试用例的执行
- 如果多个测试用例并行执行，替换全局输出目标可能会导致竞态问题，建议串行执行这类测试，或者为每个测试用例创建独立的日志实例
- 捕获日志后，需要根据日志的实际格式调整断言逻辑，比如是否包含时间戳、日志级别前缀等
- 对于第三方日志库，优先查看官方文档提供的测试辅助方法，很多库已经内置了日志捕获的测试工具
Golanggo_testlog_capturetesting修改时间：2026-07-11 00:24:35