测试辅助

DD 提供 LoggerRecorder 用于测试场景，可捕获日志条目进行断言。

LoggerRecorder

线程安全的日志记录器，用于测试中捕获和检查日志输出。

解析格式限制

记录器默认按 FormatText 解析；若 Logger 输出 JSON，须先调用 SetFormat(FormatJSON)。文本模式假定默认时间格式（ISO 8601）与默认级别字符串（DEBUG/INFO/WARN/ERROR/FATAL）；JSON 模式假定默认字段名（level/message/timestamp）。自定义 TimeFormat 或 JSONFieldNames 后，对应模式的级别/时间戳提取可能失效——此时 RawOutput 仍保存完整原始输出，可直接断言。

创建

recorder := dd.NewLoggerRecorder()

核心方法

方法	签名	说明
Writer	() io.Writer	获取 io.Writer
SetFormat	(format LogFormat)	设置日志格式（用于解析）
NewLogger	(cfg ...Config) (*Logger, error)	创建写入此记录器的 Logger（无参用 DefaultConfig；多于 1 个配置返回 ErrMultipleConfigs）
Entries	() []LogEntry	获取所有日志条目
Count	() int	条目数量
Clear	()	清除所有条目
HasEntries	() bool	是否有条目
LastEntry	() *LogEntry	最近的条目（无条目返回 nil）

Entries() 与 LastEntry() 返回深拷贝（条目结构体及其 Fields 切片均复制），修改返回值不会影响记录器内部状态。

断言方法

方法	签名	说明
EntriesAtLevel	(level LogLevel) []LogEntry	按级别过滤条目
ContainsMessage	(msg string) bool	是否包含指定消息（子串匹配，含精确匹配情形）
ContainsField	(key string) bool	是否包含指定字段
GetFieldValue	(key string) any	获取首个匹配字段的值

使用示例

基础测试

func TestLogger(t *testing.T) {
    rec := dd.NewLoggerRecorder()
    logger, _ := rec.NewLogger()

    logger.Info("hello")
    logger.Warn("warning")

    if rec.Count() != 2 {
        t.Errorf("expected 2 entries, got %d", rec.Count())
    }

    if !rec.ContainsMessage("hello") {
        t.Error("should contain 'hello'")
    }
}

级别断言

func TestLogLevel(t *testing.T) {
    rec := dd.NewLoggerRecorder()
    // 注意：Recorder 依 ISO 8601 时间戳解析级别，DevelopmentConfig 的
    // 时间格式（"15:04:05.000"）不兼容，故用 DefaultConfig 手动设 DEBUG。
    cfg := dd.DefaultConfig()
    cfg.Level = dd.LevelDebug
    logger, _ := rec.NewLogger(cfg)

    logger.Debug("debug")
    logger.Info("info")
    logger.Error("error")

    errors := rec.EntriesAtLevel(dd.LevelError)
    if len(errors) != 1 {
        t.Errorf("expected 1 error, got %d", len(errors))
    }

    debugs := rec.EntriesAtLevel(dd.LevelDebug)
    if len(debugs) != 1 {
        t.Errorf("expected 1 debug, got %d", len(debugs))
    }
}

结构化字段断言

func TestStructuredLog(t *testing.T) {
    rec := dd.NewLoggerRecorder()
    logger, _ := rec.NewLogger()

    logger.InfoWith("user login",
        dd.String("user", "admin"),
        dd.String("ip", "192.168.1.1"),
    )

    if !rec.ContainsField("user") {
        t.Error("should contain 'user' field")
    }

    user := rec.GetFieldValue("user")
    if user != "admin" {
        t.Errorf("expected user=admin, got %v", user)
    }
}

最后一条日志

func TestLastEntry(t *testing.T) {
    rec := dd.NewLoggerRecorder()
    logger, _ := rec.NewLogger()

    logger.Info("first")
    logger.Error("second")

    last := rec.LastEntry()
    if last.Level != dd.LevelError {
        t.Errorf("expected Error level, got %v", last.Level)
    }
    if last.Message != "second" {
        t.Errorf("expected 'second', got %s", last.Message)
    }
}

LogEntry

捕获的日志条目结构。

type LogEntry struct {
    Level     LogLevel
    Message   string
    Fields    []Field
    Timestamp time.Time
    Format    LogFormat
    RawOutput string
}

字段	类型	说明
Level	LogLevel	解析出的日志级别
Message	string	日志消息
Fields	[]Field	解析出的结构化字段
Timestamp	time.Time	解析出的时间戳
Format	LogFormat	捕获时使用的解析格式（由 SetFormat 设定）
RawOutput	string	原始格式化输出行

解析语义：JSON 模式下嵌套的 fields 对象会被展平为独立字段，保留键（level/message/timestamp/time/caller/file/line）不计入 Fields；文本模式按 [时间戳 级别] 文件:行 消息 key=value 布局解析，带引号的字段值会去除引号还原为原始值。

下一步

• Logger -- Logger 完整方法
• 结构化字段 -- Field 构造器
• 常量与错误 -- LogLevel 常量