spring boot 默认不输出日志到 stdout，而是写入文件（如 spring.log），导致 docker logs 不可见；必须通过 logback-spring.xml 配置 consoleappender 替换 fileappender，并添加 -dfile.encoding=utf-8 防止中文乱码。
Java 应用（尤其是基于 OpenJDK 的 Spring Boot、Java SE 等）默认不会把日志输出到 stdout，而是写入文件或通过日志框架异步落盘——这会导致 docker logs 命令完全看不到应用层日志。要让日志真正“可见”，必须切断文件写入路径，强制所有日志最终流向 System.out 或 System.err。
Spring Boot 默认日志不输出到 stdout？
Spring Boot 2.0+ 默认使用 Logback，其 starter 里内置的 logback-spring.xml 或默认配置会将日志写入 logs/spring.log（或 ./logs/ 目录），而非 stdout。即使你没改过配置，docker logs 也只看到 JVM 启动信息和少量异常堆栈（来自 stderr），但业务日志全被“吞掉”了。
- 典型现象：
docker logs -f my-java-app无业务日志，但docker exec -it my-java-app ls logs/能看到spring.log文件在增长 - 根本原因：Logback 的
FileAppender或RollingFileAppender被启用，且未显式禁用或替换为ConsoleAppender - 关键点：不能只靠
System.out.println()—— 那只是零散输出；要让整个日志框架（SLF4J → Logback）统一走控制台
Logback 配置必须用 ConsoleAppender 替换 FileAppender
修改 src/main/resources/logback-spring.xml（或 logback.xml），确保根 logger 使用 ConsoleAppender，并移除或注释掉所有 FileAppender 定义。最简有效配置如下：
<configuration><appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender"><encoder><pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern></encoder></appender><p><root level="INFO"><appender-ref ref="STDOUT"></appender-ref></root></p><div class="aritcle_card flexRow artxards">
<div class="artcardd flexRow">
<a class="aritcle_card_img" rel="nofollow" href="/xiazai/gongju/2847" title="OpenJDK 24"><img
src="https://img.php.cn/upload/manual/001/431/639/6acf4227f079d889.png" alt="OpenJDK 24" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a rel="nofollow" href="/xiazai/gongju/2847" title="OpenJDK 24" class="overflowclass">OpenJDK 24</a>
<p class="overflowclass">OpenJDK 24 Windows x64 官方参考实现（24+36），适合 Windows 环境进行 Java 开发、编译、运行和版本兼容性验证。</p>
</div>
<a rel="nofollow" href="/xiazai/gongju/2847" title="OpenJDK 24" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
</a>
</div>
</div></configuration>
- 必须删掉或注释掉类似
<appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender"></appender>的块 - 如果项目用了
logback-spring.xml，注意 Spring Profile 激活逻辑（如<springprofile name="prod"></springprofile>）可能覆盖配置，确保console在生效 profile 中 - 若用
application.properties控制日志级别（如logging.level.com.example=DEBUG），它仍有效，但输出目标由 Logback 配置决定
启动时加 -D 参数无法绕过 Logback 配置
有人尝试用 java -Dlogging.file.name=/dev/stdout -jar app.jar，但这对 Logback 无效——logging.file.name 是 Spring Boot 的属性，只影响它自己封装的 FileAppender，而不会改变 Logback 原生行为。更危险的是，/dev/stdout 在容器里不是普通文件，强行写入可能触发权限错误或阻塞。
- 错误做法：
java -Dlogging.file.name=/dev/stdout -jar app.jar→ 日志仍写不到stdout，甚至导致启动失败 - 正确做法：坚持用
ConsoleAppender，它是 Logback 原生支持、稳定可靠的控制台输出机制 - 额外提醒：不要在容器启动命令里用
> /dev/stdout重定向整个 JVM 进程输出——这会把 GC 日志、JVM 错误等混进业务日志，且无法区分stdout/stderr，破坏结构化采集
Dockerfile 和运行时别漏掉 -Dfile.encoding=UTF-8
中文日志乱码是高频问题。OpenJDK 容器镜像（如 eclipse-temurin:17-jre）默认 locale 是 C，System.out 编码可能为 US-ASCII，导致 日志内容变成????。
- 必须在
java命令中加入：-Dfile.encoding=UTF-8 - Dockerfile 示例片段：
FROM eclipse-temurin:17-jre COPY app.jar /app.jar ENTRYPOINT ["java", "-Dfile.encoding=UTF-8", "-jar", "/app.jar"]
- 若用
docker run手动启动，也要带上：docker run -d --name myapp java -Dfile.encoding=UTF-8 -jar app.jar - 这个参数必须在
-jar之前，否则 JVM 不识别
真正难的不是配出日志，而是配出「可被 fluentd/syslog 正确解析」的日志：时间戳格式要 ISO8601，每行一条，JSON 结构需扁平。一旦用了 ConsoleAppender，后续日志驱动（如 --log-driver=fluentd）才能拿到干净原始流——否则任何中间文件落地都会引入延迟、权限、轮转和磁盘满风险。
