本文旨在解决Spring应用中Thymeleaf产生过多DEBUG级别日志的问题。即使项目中未明确引入日志依赖，Thymeleaf仍可能通过传递性依赖输出详细日志。教程将指导您如何通过配置主流日志框架（如Logback）或Spring Boot的属性文件，精确控制org.thymeleaf包的日志级别，从而优化应用输出，聚焦于关键信息。
问题描述
在Spring Web应用程序启动或运行时，控制台或日志文件中可能会出现大量来自org.thymeleaf包的DEBUG级别日志信息。这些日志详细描述了Thymeleaf模板引擎的初始化过程、配置细节以及处理器注册情况，例如：
11.11.2022 14:26:15.931 [http-nio-8082-exec-1] DEBUG o.t.TemplateEngine - [THYMELEAF] INITIALIZING TEMPLATE ENGINE11.11.2022 14:26:16.222 [http-nio-8082-exec-1] DEBUG o.t.T.CONFIG - Initializing Thymeleaf Template engine configuration...[THYMELEAF] * Thymeleaf version: 3.0.15.RELEASE (built 2022-01-31T00:00:31+0000)...（大量详细配置信息）...[THYMELEAF] TEMPLATE ENGINE CONFIGURED OK11.11.2022 14:26:16.347 [http-nio-8082-exec-1] DEBUG o.t.TemplateEngine - [THYMELEAF] TEMPLATE ENGINE INITIALIZED
即使在项目的pom.xml中移除了所有显式的日志库依赖（例如Logback或Log4j2），这些Thymeleaf的DEBUG日志仍然可能持续出现。这导致日志输出过于冗长，难以快速定位重要的应用信息。
原因分析
这种现象通常是由以下几个原因造成的：
传递性依赖的日志框架： 即使项目中没有直接声明日志框架依赖，像Spring Framework、Thymeleaf或Spring Boot这样的核心库通常会引入日志门面（如SLF4J API）及其默认的日志实现（如Logback Classic、Log4j2 Core 或 java.util.logging）。这些传递性依赖可能在没有明确配置的情况下，默认以DEBUG级别输出日志。默认日志配置： 大多数日志框架在没有找到用户自定义配置文件时，会采用一套默认的配置。这套默认配置可能将某些包（包括org.thymeleaf）的日志级别设置为DEBUG，以方便开发调试。开发环境或应用服务器的默认设置： 有些IDE（如IntelliJ IDEA）或应用服务器（如Tomcat）也可能自带或注入默认的日志配置，影响到应用程序的日志输出。
因此，即使您移除了自己添加的日志依赖，系统中仍可能存在一个活跃的日志实现，并且其默认配置导致了Thymeleaf的DEBUG日志输出。
解决方案
要解决这个问题，核心思路是显式地配置应用程序的日志系统，将org.thymeleaf包的日志级别提升到INFO或更高，以抑制其DEBUG级别的输出。具体操作取决于您的项目所使用的日志框架。
1. 确定项目使用的日志框架
首先，您需要确定项目中实际生效的日志框架。
检查pom.xml： 搜索logback-classic、log4j-core、slf4j-simple等依赖。观察日志格式： 日志中出现的类名（例如ch.qos.logback表明是Logback，org.apache.logging.log4j表明是Log4j2）也能提供线索。Spring Boot项目： Spring Boot默认使用Logback，并提供了简化的配置方式。
以下将以最常见的Logback为例进行说明，并提及Spring Boot的配置方法。
2. Logback 配置示例
如果您的项目使用了Logback（这是Spring Boot的默认日志框架，也是许多Spring应用的选择），您可以通过创建或修改logback.xml或logback-spring.xml文件来控制日志级别。这些文件通常放置在src/main/resources目录下。
步骤：
添加Logback依赖（如果尚未存在）： 尽管您可能移除了，但为了确保日志配置生效，最好有明确的Logback实现依赖。
ch.qos.logback logback-classic 1.2.11
创建或修改logback.xml：
%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n
解释：
定义了日志的输出目的地和格式。 是关键。它指定了针对org.thymeleaf包及其子包的日志级别为INFO。这意味着所有低于INFO级别的日志（如DEBUG和TRACE）都将被忽略。additivity=”false” 参数非常重要。它确保了org.thymeleaf的日志在被这个特定的logger处理后，不会再被传递给父级logger（包括root logger）进行处理，从而避免日志重复输出。 设置了应用程序的默认日志级别为INFO。
3. Spring Boot 项目配置
对于Spring Boot项目，配置日志级别更加简单，通常不需要直接修改logback.xml（除非有更复杂的定制需求）。您可以通过application.properties或application.yml文件进行配置。
使用application.properties：
在src/main/resources/application.properties文件中添加以下行：
logging.level.org.thymeleaf=INFOlogging.level.org.springframework=INFO# 如果需要，也可以设置全局默认级别logging.level.root=INFO
使用application.yml：
在src/main/resources/application.yml文件中添加以下配置：
logging: level: org: thymeleaf: INFO springframework: INFO root: INFO
Spring Boot的这种配置方式会自动与底层的日志框架（通常是Logback）进行集成，实现日志级别的控制。
4. Log4j2 配置示例
如果您的项目使用的是Log4j2，您需要创建或修改log4j2.xml文件，通常也放在src/main/resources目录下。
注意事项
配置文件的优先级： 如果同时存在多个日志配置文件（例如logback.xml和logback-spring.xml），或者Spring Boot的application.properties/yml与日志框架的配置文件同时存在，需要了解其加载优先级。通常，Spring Boot会优先加载application.properties/yml中的日志配置，然后是logback-spring.xml，最后是logback.xml。重启应用程序： 修改日志配置文件后，通常需要重启应用程序才能使新的配置生效。日志级别选择： INFO级别通常是生产环境的推荐级别，它会输出重要的业务信息和应用程序状态，但会过滤掉详细的调试信息。如果您需要更少的日志，可以设置为WARN或ERROR。additivity属性： 在Logback和Log4j2中，additivity=”false”（或Log4j2中的additivity=”false”）用于防止日志消息被父级logger重复处理。如果省略或设置为true，则org.thymeleaf的INFO级别日志可能会先被其自身的logger处理，然后再次被root logger处理，导致日志重复。
总结
通过显式地配置日志框架，您可以精确控制应用程序中各个组件的日志输出行为。对于Thymeleaf产生的冗余DEBUG日志，只需在您的日志配置文件中为org.thymeleaf包设置合适的日志级别（例如INFO），即可有效抑制这些不必要的详细信息，使您的日志输出更加清晰和有用。这种方法不仅适用于Thymeleaf，也适用于控制其他第三方库或您自己应用程序模块的日志输出。
以上就是如何有效控制Thymeleaf的日志输出级别的详细内容，更多请关注创想鸟其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/66775.html
微信扫一扫 
支付宝扫一扫 
