如何在 Java 中利用 System.setErr() 将程序的异常错误信息输出重定向到特定日志流

System.setErr() 可以让开发者把 System.err 的输出流导向自定义的 PrintStream——比如写入文件、内存缓冲区，或者直接桥接到日志框架。不过需要注意的是，它只对程序主动通过 System.err 发出的内容生效（比如手动调用的 e.printStackTrace()）；要想拦截那些没有被 try-catch 包裹的未处理异常，JVM 默认会调用 Thread.getUncaughtExceptionHandler()，此时还需要配合 Thread.setDefaultUncaughtExceptionHandler 才能一并捕获。

重定向 System.err 到文件日志流

创建一个指向日志文件的 PrintStream，再通过 System.setErr() 替换掉默认的错误流，操作起来并不复杂。但有几个细节需要留意：

• 确保文件路径可写。推荐使用 FileOutputStream 的追加模式（第二个参数传 true），避免每次启动都覆盖历史日志。
• 显式调用 flush()，或者在构造 PrintStream 时开启自动刷新（第三个参数传 true），防止因缓冲导致日志在程序崩溃时丢失。
• 最好在程序启动的早期（比如 main 方法的第一行）就完成设置，否则有些早期的错误输出依然会落到控制台上。

示例代码如下：

try {
    PrintStream logStream = new PrintStream(new FileOutputStream("app-error.log", true), true);
    System.setErr(logStream);
} catch (FileNotFoundException e) {
    e.printStackTrace(); // 此时仍走原始 System.err
}

与日志框架（如 Log4j/SLF4J）桥接输出

如果项目已经接入了成熟的日志框架（Log4j、Logback、SLF4J 等），不建议直接把 System.err 重定向到文件，更好的做法是将其桥接到框架的 logger，从而统一日志格式、级别和滚动策略。具体来说，可以创建一个 PrintStream 包装器，把每一行输出转换为 logger.error() 调用。这里有几个要点：

• 线程安全：多个线程同时往 System.err 写数据时，会并发调用这个包装器，所以依赖的 logger 本身必须是线程安全的（主流日志框架都满足）。
• 避免无限递归：包装器内部不要再调用 e.printStackTrace(System.err)，否则会陷入死循环。

一个简化实现的示意：

PrintStream bridge = new PrintStream(new OutputStream() {
    @Override
    public void write(int b) throws IOException { /* 忽略单字节写入 */ }
    @Override
    public void write(byte[] b, int off, int len) throws IOException {
        String line = new String(b, off, len).trim();
        if (!line.isEmpty()) {
            logger.error(line);
        }
    }
}, true); // 自动 flush
System.setErr(bridge);

临时重定向 + 恢复原始错误流

有些场景（比如单元测试、调试模块）需要临时切换 System.err，之后还要还原回去。这时候必须在设置新流之前，先把原始的 System.err 引用存起来：

• 调用 System.setErr() 前，用 System.err 获取当前值并缓存到本地变量。
• 操作完成后（建议放在 finally 块中），调用 System.setErr(originalErr) 恢复。
• 注意：不能想当然地认为 System.out 或 System.in 能代表原始 err，必须显式保存。

示例：

PrintStream originalErr = System.err;
try {
    System.setErr(new PrintStream(new ByteArrayOutputStream()));
    // 执行可能触发 System.err 输出的代码
} finally {
    System.setErr(originalErr);
}

重要限制与补充建议

System.setErr() 是 JVM 级别的全局设置，会影响到所有线程。但它有一个关键限制：无法捕获未处理的 RuntimeException 或 Error 的堆栈打印行为本身。当 JVM 遇到一个未被线程捕获的异常时，它会主动调用 Thread.getUncaughtExceptionHandler()，默认的 handler 才会执行 printStackTrace(System.err)。换句话说：

• 如果想拦截所有未捕获异常的输出，必须同时设置 Thread.setDefaultUncaughtExceptionHandler。
• 对于已经捕获但手动调用 e.printStackTrace() 的异常，重定向 System.err 可以直接生效。
• 生产环境更推荐使用 ja va.util.logging、Logback 或 Log4j 的 ConsoleAppender 配置，而不是直接操作 System.err——这样既灵活又可靠。