如何处理控制台日志？阻止非预期输出干扰JSON日志解析

针对第三方库乱输出非结构化内容破坏JSON日志解析的问题，以下是几种实用方案：

1. 重定向默认Console输出到STDERR或/dev/null #

把所有通过Console.Write/WriteLine产生的非结构化输出，直接转到STDERR（Kubernetes会单独收集该流，不会干扰STDOUT的JSON解析），或者直接丢弃。

示例（C#）： #

// 在应用启动初期执行，将默认Console输出重定向到STDERR
Console.SetOut(Console.Error);
// 或者直接丢弃输出（Linux/macOS）
Console.SetOut(new StreamWriter(File.Open("/dev/null", FileMode.Append)));

示例（Java）： #

// 将System.out重定向到System.err
System.setOut(System.err);
// 或者丢弃输出
System.setOut(new PrintStream(new FileOutputStream("/dev/null")));

容器级别重定向（Docker/K8s）： #

如果不想改代码，可以在启动命令里通过shell重定向实现：

# 把应用的默认STDOUT（Console输出）转到STDERR，仅保留日志框架的输出到真正的STDOUT
dotnet MyApp.exe 1>&2

2. 自定义Console输出拦截器 #

通过自定义输出流，拦截所有Console调用，可选择将其标记为非结构化日志后输出到STDERR，或者直接过滤。

示例（C#自定义TextWriter）： #

public class NonStructuredLogWriter : TextWriter
{
    private readonly TextWriter _target;

    public NonStructuredLogWriter(TextWriter target)
    {
        _target = target;
    }

    public override Encoding Encoding => Encoding.UTF8;

    public override void WriteLine(string value)
    {
        // 给非结构化内容加标记，方便后续区分
        _target.WriteLine($"[UNSTRUCTURED] {value}");
    }

    public override void Write(string value)
    {
        _target.Write($"[UNSTRUCTURED] {value}");
    }
}

// 启动时设置
Console.SetOut(new NonStructuredLogWriter(Console.Error));

3. 让日志框架直接独占STDOUT #

确保你的结构化日志框架直接写入原始STDOUT流，不依赖Console类。比如Serilog、NLog等框架都支持直接配置输出到控制台的原始流，绕过默认Console的输出管道。

示例（Serilog配置）： #

Log.Logger = new LoggerConfiguration()
    .WriteTo.Console(new JsonFormatter()) // 直接输出JSON到STDOUT
    .CreateLogger();

此时，即使第三方库调用Console.Write，只要你已经重定向了Console.Out，就不会影响Serilog输出的JSON日志。

关键注意事项 #

• 务必在应用启动最早期执行重定向操作，确保第三方库的初始化代码产生的输出也能被拦截。
• Kubernetes环境中，STDERR的日志会被单独收集，不会干扰STDOUT的JSON解析，所以将非结构化输出转到STDERR是最稳妥的选择。

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