Java应用启动无日志输出，大概率因logback.xml未置于src/main/resources导致SLF4J退化为NOOP；需验证其是否在target/classes下、确认IDE中resources为资源根、打印Logger类名验证Logback生效，并注意Docker中路径权限与stdout重定向问题。

Java应用启动时日志没输出，大概率是logback.xml没被正确加载

Java项目默认不带日志实现，得自己选一个（如Logback、Log4j2），再配好配置文件。常见问题是把logback.xml放在src/main/java下——它必须在类路径根目录（即src/main/resources），否则SLF4J找不到，会退化成NOOP，日志完全静默。

• 检查target/classes/（或build/classes）下是否存在logback.xml，不存在就说明打包或路径错了
• IDE里刷新Maven/Gradle项目后，确认resources被标记为“Resources Root”
• 加一句System.out.println(org.slf4j.LoggerFactory.getLogger("test").getClass().getName());，看是否打印ch.qos.logback.classic.Logger，不是就说明没走Logback

想按环境切换日志级别，别硬编码，用springProfile或property动态控制

直接在logback.xml里写死<level value="DEBUG"></level>会导致测试环境打太多日志，生产又看不到关键信息。Logback支持条件化配置，比手动改配置更可靠。

• 用<springprofile name="prod"></springprofile>包裹生产专用配置（Spring Boot项目才认这个）
• 通用做法是用<property resource="application.properties"></property>读取外部属性，再用${LOG_LEVEL:-INFO}设置默认值
• 避免在<appender></appender>里嵌套<filter></filter>做级别拦截——性能差，应直接在<logger></logger>上设level

AsyncAppender能提速，但没配queueSize和discardingThreshold可能丢日志

异步日志本质是把日志事件丢进队列，由后台线程消费。默认队列大小是256，如果日志暴增（比如循环里打DEBUG），队列满后默认丢弃新日志，且不报错，非常隐蔽。

java-api-doc-generator

分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。

下载

• 显式设置<queuesize>1024</queuesize>，并配<discardingthreshold>0</discardingthreshold>（0表示不丢弃，阻塞主线程直到有空位）
• 务必加<includecallerdata>false</includecallerdata>，否则每次都要解析栈帧，性能暴跌
• 别给AsyncAppender套AsyncAppender——不生效，还多一层调度开销

部署到Docker后日志消失，重点查stdout重定向和logback.xml中的file路径

Docker容器通常只捕获stdout/stderr，如果你的logback.xml里用了<appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender"></appender>，而路径写的是/var/log/app.log，但容器里没创建该目录或无写权限，日志就全丢了，且无任何提示。

立即学习“Java免费学习笔记（深入）”；

• 开发阶段优先用ConsoleAppender，确保基础输出通路正常
• 文件路径尽量用相对路径，如logs/app.log，并在Dockerfile里RUN mkdir -p logs
• 加<appender-ref ref="STDOUT"></appender-ref>保底，哪怕文件写失败，至少还能看到部分日志

日志配置最麻烦的从来不是语法，而是环境差异带来的路径、权限、类加载顺序问题——每次换环境都得重新验证logback.xml是否真被加载、是否真在写、写到了哪。