生产环境应禁用 DEBUG 和 TRACE 日志，需同时设置 Logger 和 Handler 级别为 INFO 或更高；推荐通过 logging.properties 外置配置，并验证 fine() 等低级别日志是否被彻底屏蔽。

在生产环境中，应禁用 DEBUG 和 TRACE 级别日志，只保留 INFO 及以上（如 WARNING、SEVERE）的日志输出。关键在于**同时控制 Logger 实例级别和 Handler 的级别**，二者需协同生效。

明确 Logger 与 Handler 的双级过滤机制

java.util.logging.Logger 本身有一个日志级别（setLevel()），它决定“是否把这条日志传给 Handler”；而每个 Handler（如 ConsoleHandler 或 FileHandler）也有自己的级别（setLevel()），决定“是否实际输出”。只有两者都允许，日志才会出现。

• 若 Logger 级别设为 INFO，但 Handler 设为 WARNING，则 INFO 日志会被 Logger 拦截，不会到达 Handler
• 若 Logger 设为 ALL，但 Handler 是 SEVERE，那么只有 SEVERE 日志会被输出
• 生产环境推荐：Logger 设为 INFO，Handler 也设为 INFO 或更高（如 WARNING），确保 DEBUG 被彻底过滤

通过 logging.properties 文件统一配置（推荐用于生产）

将配置外置为 logging.properties 文件，避免硬编码，便于不同环境切换：

<font size="2"># 全局默认级别（影响未显式设置的 Logger）<br>.level = INFO<br><br># 控制台输出仅显示 WARNING 及以上（可选，更保守）<br>java.util.logging.ConsoleHandler.level = WARNING<br>java.util.logging.ConsoleHandler.formatter = java.util.logging.SimpleFormatter<br><br># 文件输出设为 INFO（常用）<br>java.util.logging.FileHandler.level = INFO<br>java.util.logging.FileHandler.pattern = app.log<br>java.util.logging.FileHandler.formatter = java.util.logging.SimpleFormatter<br><br># 指定你应用的 Logger（如 com.example.MyService）<br>com.example.level = INFO<br>com.example.handlers = java.util.logging.FileHandler</font>

启动时通过 JVM 参数加载：
-Djava.util.logging.config.file=./logging.properties

java-api-doc-generator

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

下载

代码中动态设置（适用于测试或临时调试）

不建议在生产代码中硬写 logger.setLevel(Level.DEBUG)，但可在初始化阶段按环境判断：

<font size="2">Logger logger = Logger.getLogger("com.example.MyService");<br>// 从系统属性或配置中心读取环境标识<br>String env = System.getProperty("app.env", "prod");<br>if ("dev".equals(env) || "test".equals(env)) {<br>    logger.setLevel(Level.ALL);<br>    for (Handler h : logger.getHandlers()) {<br>        h.setLevel(Level.ALL);<br>    }<br>} else {<br>    logger.setLevel(Level.INFO);<br>    for (Handler h : logger.getHandlers()) {<br>        h.setLevel(Level.INFO);<br>    }<br>}</font>

注意：若 Handler 是全局添加（如 root Logger 的 ConsoleHandler），需对 root 或对应 Handler 单独设置，否则子 Logger 设置可能无效。

验证 DEBUG 是否真正被屏蔽

写一行 logger.fine("This is debug")（fine 对应 DEBUG），再执行并检查日志文件/控制台。若仍出现，常见原因有：

• Logger 实例的父 Logger（如 root）级别是 ALL，且未关闭其 Handler 继承 —— 可调用 logger.setUseParentHandlers(false)
• 使用了 logger.debug(...) 但该方法不存在（JUL 没有 debug()），应改用 finer() / fine() / config()，它们分别对应 FINER / FINE / CONFIG，均低于 INFO
• 自定义 Handler 或 Formatter 干扰了级别判断 —— 确保未重写 publish() 逻辑绕过级别检查

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南