必须在main方法第一行调用System.setOut()，早于SpringApplication.run()，否则Banner、Actuator等组件及静态块中的System.out::println已固化输出流，重定向失效。
为什么不能直接在Spring Boot启动后调用System.setOut()
因为很多框架组件（比如Spring Boot的Banner、Actuator端点初始化、日志桥接器）会在ApplicationRunner或CommandLineRunner执行前就写System.out。一旦错过这个窗口，重定向就失效——你看到的日志文件里可能只有最后几行，前面全是控制台输出。
更隐蔽的问题是：某些类在静态初始化块中就用了System.out::println，而方法引用会固化当时System.out的实例，后续setOut()完全不起作用。
- 必须在
main方法第一行就调用System.setOut()，早于SpringApplication.run() - 避免使用
System.out::println作为函数式接口实现；改用s -> System.out.println(s)确保每次动态读取 - 如果用了Lombok的
@Slf4j或SLF4J桥接器，确认slf4j-simple或jul-to-slf4j已正确配置，否则System.out不会被自动捕获
如何让重定向同时保留控制台输出（仅限开发环境）
生产环境禁用System.out是共识，但开发阶段需要快速验证又不想切日志文件——这时候硬编码双写流最可靠，不依赖第三方库。
Apache Commons IO的TeeOutputStream虽好，但引入额外依赖且对PrintStream封装不够透明；自己写一个轻量包装类反而更可控。
- 继承
PrintStream，构造时传入FileOutputStream和原始System.out - 复写
println(String)等关键方法，内部调用两次super.println()（一次写文件，一次写原始out） - 用
@Profile("!prod")条件化启用该包装，生产环境直接用空ByteArrayOutputStream丢弃输出 - 注意：不要在包装类里做
System.setOut()，应由外部统一调用，避免重复设置
路径、编码、线程安全三个最容易翻车的点
new FileOutputStream("log.txt", true)看着没问题，但部署到Docker容器或K8s Pod里，相对路径"log.txt"往往落在/tmp或只读文件系统上，导致FileNotFoundException静默失败——System.out直接变黑洞。
- 路径必须用绝对路径：
Paths.get(System.getProperty("user.dir"), "logs", "system-out.log")，并提前Files.createDirectories() - 编码必须显式指定
"UTF-8"：Windows默认GBK，Linux多为UTF-8，不指定会导致中文全乱码 -
PrintStream本身线程安全，但如果你手动加了缓冲或异步队列，就得自己保证flush()时机，否则日志延迟严重甚至丢失 - 别忘了
close()——虽然System.setOut()不会自动关流，但应用关闭前应主动ps.close()，否则JVM退出时可能丢最后一段
真正该停用System.out的两个信号
当项目出现以下任一情况，说明靠重定向已治标不治本，该迁移到日志框架了：
- 不同模块的
System.out输出混在一起，无法按级别过滤（比如只想看ERROR，却得grep一堆INFO） - 日志文件涨到几个GB没人敢删，因为没滚动策略，也没归档机制
这时候重定向只是把问题从控制台搬到了文件，而SLF4J + Logback天然支持%d{yyyy-MM-dd HH:mm:ss.SSS}格式化、SizeAndTimeBasedRollingPolicy滚动、异步Appender削峰——这些不是“高级功能”，是企业级运维的底线配置。
