Effect-TS项目中Logger替换问题的解决方案

理解Effect-TS的日志系统

Effect-TS是一个强大的TypeScript函数式编程框架，它提供了完善的日志记录功能。框架默认使用"pretty logger"（美观日志）来格式化输出，这对于开发环境非常友好，能够清晰地展示日志信息。

问题背景

在Effect-TS项目中，开发者有时需要将默认的日志格式替换为JSON格式，特别是在生产环境中，JSON格式更易于日志收集和分析系统的处理。然而，直接使用Logger.json替换默认logger时可能会遇到不生效的情况。

问题根源分析

这个问题出现的原因是NodeRuntime.runMain方法默认启用了两个功能：

1. 美观日志格式化（pretty logger）
2. 错误报告功能

这些默认设置会覆盖开发者手动配置的logger，导致JSON logger无法按预期工作。

解决方案

要正确替换为JSON logger，需要明确关闭NodeRuntime.runMain的默认设置：

NodeRuntime.runMain(program, {
  disablePrettyLogger: true,
  disableErrorReporting: true
})

完整示例代码

import { NodeRuntime } from "@effect/platform-node"
import { Config, Effect, Logger } from "effect"

// 主程序逻辑
const program = Config.string("FOO").pipe(
  // 显式记录错误
  Effect.tapErrorCause(Effect.logError),
  // 使用JSON logger
  Effect.provide(Logger.json)
)

// 运行程序并关闭默认logger
NodeRuntime.runMain(program, {
  disablePrettyLogger: true,
  disableErrorReporting: true
})

实际应用场景

这种配置特别适合以下场景：

1. 生产环境日志收集
2. 需要将日志导入ELK等日志分析系统
3. 需要结构化日志进行自动化处理

最佳实践建议

1. 开发环境可以保留默认的pretty logger，便于调试
2. 生产环境建议使用JSON logger，便于日志分析
3. 对于关键错误，建议使用Effect.tapErrorCause(Effect.logError)显式记录
4. 考虑根据环境变量动态切换logger配置

通过理解Effect-TS的日志系统工作原理，开发者可以更灵活地配置适合自己项目的日志方案。