在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 ENGINE 11.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 OK 11.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实现依赖。
<dependency> <groupId>ch.qos.logback</groupId> <artifactId>logback-classic</artifactId> <version>1.2.11</version> <!-- 请使用适合您项目的版本 --> <!-- 如果是Spring Boot项目，通常由spring-boot-starter-logging自动引入，无需手动添加 --> </dependency> -
创建或修改logback.xml：
Teleporthq
一体化AI网站生成器，能够快速设计和部署静态网站
182
查看详情
<?xml version="1.0" encoding="UTF-8"?> <configuration> <!-- 定义一个控制台输出的Appender --> <appender name="CONSOLE" 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> <!-- 设置org.thymeleaf包的日志级别为INFO，以抑制DEBUG输出 --> <!-- additivity="false" 表示该logger的日志不会再传递给父logger（root），避免重复输出 --> <logger name="org.thymeleaf" level="INFO" additivity="false"> <appender-ref ref="CONSOLE"/> </logger> <!-- 设置Spring框架相关包的日志级别为INFO，如果需要的话 --> <logger name="org.springframework" level="INFO" additivity="false"> <appender-ref ref="CONSOLE"/> </logger> <!-- 根logger，设置默认的日志级别为INFO，并关联到CONSOLE Appender --> <root level="INFO"> <appender-ref ref="CONSOLE"/> </root> </configuration>解释：
- <appender> 定义了日志的输出目的地和格式。
- <logger name="org.thymeleaf" level="INFO" additivity="false"> 是关键。它指定了针对org.thymeleaf包及其子包的日志级别为INFO。这意味着所有低于INFO级别的日志（如DEBUG和TRACE）都将被忽略。
- additivity="false" 参数非常重要。它确保了org.thymeleaf的日志在被这个特定的logger处理后，不会再被传递给父级logger（包括root logger）进行处理，从而避免日志重复输出。
- <root level="INFO"> 设置了应用程序的默认日志级别为INFO。
对于Spring Boot项目，配置日志级别更加简单，通常不需要直接修改logback.xml（除非有更复杂的定制需求）。您可以通过application.properties或application.yml文件进行配置。
使用application.properties：
在src/main/resources/application.properties文件中添加以下行：
logging.level.org.thymeleaf=INFO logging.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目录下。
<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="WARN">
<Appenders>
<Console name="Console" target="SYSTEM_OUT">
<PatternLayout pattern="%d{yyyy-MM-dd HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n"/>
</Console>
</Appenders>
<Loggers>
<!-- 设置org.thymeleaf包的日志级别为INFO -->
<Logger name="org.thymeleaf" level="info" additivity="false">
<AppenderRef ref="Console"/>
</Logger>
<!-- 设置Spring框架相关包的日志级别为INFO -->
<Logger name="org.springframework" level="info" additivity="false">
<AppenderRef ref="Console"/>
</Logger>
<!-- 根Logger，设置默认日志级别为INFO -->
<Root level="info">
<AppenderRef ref="Console"/>
</Root>
</Loggers>
</Configuration> 注意事项
- 配置文件的优先级： 如果同时存在多个日志配置文件（例如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的日志输出级别的详细内容，更多请关注知识资源分享宝库其它相关文章！
相关标签： java apache idea 处理器 app tomcat ai 配置文件 web应用程序 开发环境 Java tomcat spring spring boot logback log4j xml Error Logging ide idea intellij idea apache 大家都在看： 从字符索引映射重建字符串：Java 教程 如何在Java中开发音乐播放器 Java中如何实现Todo待办事项应用 Java中异常链 cause使用方法 IntelliJ IDEA安装与Java配置方法
发表评论:
◎欢迎参与讨论，请在这里发表您的看法、交流您的观点。