<think>我们正在处理一个Spring Boot应用启动时的日志配置错误，错误信息是：
`
Logback配置错误，
ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP类找不到，ERROR: Filename pattern contains %i token converter incompatible`
根据错误信息，问题出现在
Logback的配置中，具体是使用了`%i`（索引）的转换模式，但是相关的类`
SizeAndTimeBasedFNATP`找不到。
分析原因：
1
. 在
Logback的旧版本中，我们使用`
SizeAndTimeBasedFNATP`类来实现基于时间和文件大小的滚动策略，并且文件名模式中需要同时包含`%d`（日期）和`%i`（索引）两个转换符。
2
. 在
Logback的新版本中（从1
.1
.7版本开始），这个类被重命名为`SizeAndTimeBased
RollingPolicy`，并且对应的配置方式也有所改变。
因此，这个错误通常是因为
Logback版本升级导致的类名变更。在Spring Boot的早期版本中，默认集成的
Logback版本可能较低，而升级到较新的Spring Boot版本后，
Logback版本也随之升级，导致旧配置失效。
解决方案：
1
. 修改
Logback配置文件（如
logback-spring
.xml），将旧的`
SizeAndTimeBasedFNATP`配置方式更新为新的`SizeAndTimeBased
RollingPolicy`。
具体步骤：
旧配置可能类似于：
```xml
<appender name="FILE" class="
ch.qos.logback.core.rolling.RollingFileAppender">
<file>${LOG_FILE}</file>
<
rollingPolicy class="
ch.qos.logback.core.rolling.TimeBased
RollingPolicy">
<fileNamePattern>${LOG_FILE}
.%d{yyyy-MM-dd}
.%i
.log</fileNamePattern>
<timeBasedFileNamingAndTriggeringPolicy class="
ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
<maxFileSize>${LOG_FILE_MAX_SIZE:-10MB}</maxFileSize>
</timeBasedFileNamingAndTriggeringPolicy>
<maxHistory>${LOG_FILE_MAX_HISTORY:-30}</maxHistory>
</
rollingPolicy>
...
</appender>
```
新配置应该改为：
```xml
<appender name="FILE" class="
ch.qos.logback.core.rolling.RollingFileAppender">
<file>${LOG_FILE}</file>
<
rollingPolicy class="
ch.qos.logback.core.rolling.SizeAndTimeBased
RollingPolicy">
<!-- 文件名模式同时包含日期和索引 -->
<fileNamePattern>${LOG_FILE}
.%d{yyyy-MM-dd}
.%i
.log</fileNamePattern>
<!-- 设置每个文件的最大大小 -->
<maxFileSize>${LOG_FILE_MAX_SIZE:-10MB}</maxFileSize>
<!-- 保留的历史日志文件数量 -->
<maxHistory>${LOG_FILE_MAX_HISTORY:-30}</maxHistory>
<!-- 可选：设置总大小限制 -->
<totalSizeCap>${LOG_FILE_TOTAL_SIZE_CAP:-0}</totalSizeCap>
</
rollingPolicy>
...
</appender>
```
注意：新的配置方式中，我们直接使用`SizeAndTimeBased
RollingPolicy`作为滚动策略，并且将原来在`
SizeAndTimeBasedFNATP`中配置的`maxFileSize`移到了`
rollingPolicy`中。
2
. 另外，确保你的Spring Boot版本对应的
Logback版本是兼容的。Spring Boot 2
.x默认使用
Logback 1
.2
.x以上版本，而
Logback 1
.1
.7及以上版本已经使用新的类名。
3
. 如果问题仍然存在，检查项目中是否有多个
Logback的配置文件，或者是否有依赖引入了旧版本的
Logback（比如通过其他依赖传递）。可以通过Maven的依赖树检查：
```
mvn dependency:tree
```
确保使用的
Logback版本至少是1
.1
.7。
4
. 如果项目中没有显式配置
Logback，而是使用Spring Boot的默认配置，那么可能需要检查是否在配置文件中（如application
.properties）设置了日志文件名的模式。在Spring Boot中，我们可以通过以下属性设置日志滚动策略：
```properties
logging
.pattern
.rolling-file-name=your_log
.%d{yyyy-MM-dd}
.%i
.log
```
但是，这种配置方式在底层也是使用
Logback的，所以同样需要新的
Logback版本支持`%i`。如果使用的是旧版本，同样会出现问题。
因此，建议升级Spring Boot到较新的版本（如2
.2
.x以上），并确保
Logback版本在1
.1
.7以上。
如果项目无法升级Spring Boot，那么可能需要降级
Logback版本（不推荐，因为可能有安全漏洞），或者修改配置不使用`%i`（即不使用基于文件大小的滚动，只使用时间滚动）。
但是，根据错误信息，配置中包含了`%i`，所以必须使用支持`%i`的滚动策略。因此，升级
Logback配置是根本的解决方法。
总结：修改
Logback配置文件，使用新的`SizeAndTimeBased
RollingPolicy`类替代旧的`
SizeAndTimeBasedFNATP`。
下面是一个完整的新配置示例（
logback-spring
.xml）：
```xml
<?xml version="1
.0" encoding="UTF-8"?>
<configuration>
<include resource="org/springframework/boot/logging/
logback/defaults
.xml" />
<property name="LOG_FILE" value="${LOG_FILE:-${LOG_PATH:-${LOG_TEMP:-${java
.io
.tmpdir:-/tmp}}}/spring
.log}"/>
<property name="LOG_FILE_MAX_SIZE" value="10MB" />
<property name="LOG_FILE_MAX_HISTORY" value="30" />
<appender name="FILE" class="
ch.qos.logback.core.rolling.RollingFileAppender">
<file>${LOG_FILE}</file>
<encoder>
<pattern>${FILE_LOG_PATTERN}</pattern>
</encoder>
<
rollingPolicy class="
ch.qos.logback.core.rolling.SizeAndTimeBased
RollingPolicy">
<fileNamePattern>${LOG_FILE}
.%d{yyyy-MM-dd}
.%i
.log</fileNamePattern>
<maxFileSize>${LOG_FILE_MAX_SIZE}</maxFileSize>
<maxHistory>${LOG_FILE_MAX_HISTORY}</maxHistory>
</
rollingPolicy>
</appender>
<root level="INFO">
<appender-ref ref="FILE" />
</root>
</configuration>
```
注意：上面的配置中，我们使用了`SizeAndTimeBased
RollingPolicy`，并且`fileNamePattern`中同时包含了`%d`和`%i`。
修改后，重新启动应用，问题应该得到解决。
如果问题依旧，请检查
Logback的版本。在Spring Boot 2
.2
.5
.RELEASE中，默认的
Logback版本是1
.2
.3，这个版本是支持`SizeAndTimeBased
RollingPolicy`的。
相关问题：
1
. 如何在Spring Boot中配置
Logback日志？
2
. Logback滚动策略有哪些？
3
. 如何解决
Logback配置中的类找不到问题？
4
. Spring Boot升级后日志配置不兼容怎么办？</think>### 分析及解决
Logback 配置错误：`
SizeAndTimeBasedFNATP` 类找不到
#### 问题原因
该错误通常由以下原因引起：
1
. **
Logback 版本兼容性问题**
`
SizeAndTimeBasedFNATP` 类在
Logback 1
.1
.7+ 版本中已被
弃用，并在 1
.2
.0+ 版本中被移除[^1]。Spring Boot 2
.2
.x+ 默认使用
Logback 1
.2
.x+，导致旧配置失效。
2
. **配置语法过时**
错误信息 `Filename pattern contains %i token converter incompatible` 表明配置中使用了旧版滚动策略语法：
```xml
<!-- 过时语法 (
Logback <1
.1
.7) -->
<timeBasedFileNamingAndTriggeringPolicy
class="
ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
```
3
. **依赖冲突**
项目中可能存在多个
Logback 版本或 SLF4J 绑定冲突。
---
### 解决方案
#### 步骤 1：更新
Logback 配置
使用新版 `SizeAndTimeBased
RollingPolicy` 替代
弃用的 `FNATP` 类：
```xml
<!--
logback-spring
.xml 新版配置 -->
<configuration>
<appender name="
ROLLING" class="
ch.qos.logback.core.rolling.RollingFileAppender">
<file>logs/app
.log</file>
<
rollingPolicy class="
ch.qos.logback.core.rolling.SizeAndTimeBased
RollingPolicy">
<!-- 关键：使用 %i 需包含 %d -->
<fileNamePattern>logs/app
.%d{yyyy-MM-dd}
.%i
.log</fileNamePattern>
<maxFileSize>200MB</maxFileSize> <!-- 引用[2]中的配置 -->
<maxHistory>30</maxHistory> <!-- 引用[2] -->
</
rollingPolicy>
<encoder>
<pattern>%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36} - %msg%n</pattern>
</encoder>
</appender>
<root level="${
logback.rootLevel:-DEBUG}"> <!-- 引用[2] -->
<appender-ref ref="
ROLLING" />
</root>
</configuration>
```
#### 步骤 2：检查依赖版本
确保 `pom
.xml` 使用兼容组合：
```xml
<!-- Spring Boot 2
.2
.x+ 需匹配
Logback 1
.2
.x+ -->
<parent>
<groupId>org
.springframework
.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>2
.2
.5
.RELEASE</version> <!-- 引用[4] -->
</parent>
<dependencies>
<dependency>
<groupId>
ch.qos.logback</groupId>
<artifactId>
logback-classic</artifactId>
<version>1
.2
.11</version> <!-- 最低要求 1
.2
.0 -->
</dependency>
</dependencies>
```
#### 步骤 3：解决冲突
检查依赖冲突：
```bash
mvn dependency:tree | grep
logback
```
若存在多个版本，通过 `<exclusions>` 解决：
```xml
<dependency>
<groupId>com
.example</groupId>
<artifactId>problematic-lib</artifactId>
<exclusions>
<exclusion>
<groupId>
ch.qos.logback</groupId>
<artifactId>
logback-classic</artifactId>
</exclusion>
</exclusions>
</dependency>
```
#### 步骤 4：验证配置
在 `application
.properties` 激活配置检查：
```properties
# 开启配置调试模式
logging
.config=classpath:
logback-spring
.xml
debug=true
```
启动应用观察日志输出：
```
15:30:00,000 |-INFO in
RollingFileAppender[
ROLLING] - Active log file: logs/app
.log
```
---
### 关键注意事项
1
. **文件名模式规则**
`%i`（索引）必须与 `%d{pattern}` 同时使用，否则触发 `incompatible token` 错误。
2
. **Profile 配置**
使用 `
logback-spring
.xml` 替代 `
logback.xml` 以支持 Spring Profile[^1]：
```xml
<springProfile name="staging">
<maxHistory>60</maxHistory> <!-- 生产环境保留更多日志 -->
</springProfile>
```
3
. **日志工厂兼容性**
确保日志工厂类使用 SLF4J 接口（引用[3]）：
```java
import org
.slf4j
.Logger;
import org
.slf4j
.LoggerFactory;
public class LogFactory {
private static final Logger logger = LoggerFactory
.getLogger(LogFactory
.class);
//
... 方法实现
}
```
---
### 相关问题
1
. **如何在 Spring Boot 中配置多环境日志策略？**
> 使用 `
logback-spring
.xml` 结合 `<springProfile>` 标签，为不同环境设置滚动策略[^1]。
2
. **升级 Spring Boot 后出现 `NoClassDefFoundError` 如何解决？**
> 检查依赖树中的版本冲突，使用 `mvn dependency:tree` 分析并排除旧版依赖。
3
. **
Logback 和 Log4j2 在 Spring Boot 中如何选择？**
>
Logback 是 Spring Boot 默认实现，需排除 `spring-boot-starter-logging` 并引入 `spring-boot-starter-log4j2` 切换。
4
. **如何动态修改运行时的日志级别？**
> 通过 Spring Boot Actuator 的 `/actuator/loggers` 端点动态调整，需添加依赖：
> ```xml
> <dependency>
> <groupId>org
.springframework
.boot</groupId>
> <artifactId>spring-boot-starter-actuator</artifactId>
> </dependency>
> ```
[^1]: Spring Boot 日志配置要求
[^2]:
Logback 参数配置示例
[^3]: 日志工厂实现规范
[^4]: Spring Boot 依赖管理要求
扫一扫
897
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
