logback无法创建S3FixedWindowRollingPolicy类型的rollingPolicy组件

核心原因 #

S3FixedWindowRollingPolicy不属于官方logback-core/logback-classic包，它是第三方开源库logback-s3-rolling-policy提供的类，你当前的依赖清单里没有引入这个库，同时配置里的类路径也写错了，这两个问题共同导致了类找不到错误。

解决方案步骤 #

1. 添加正确的Maven依赖 #

在pom.xml中引入第三方滚动策略库（建议使用最新稳定版本）：

<dependency>
    <groupId>com.github.link-nv</groupId>
    <artifactId>logback-s3-rolling-policy</artifactId>
    <version>1.8.0</version>
</dependency>

同时需确保项目包含AWS S3 SDK依赖（以AWS SDK v2为例，可根据实际版本调整）：

<dependency>
    <groupId>software.amazon.awssdk</groupId>
    <artifactId>s3</artifactId>
    <version>2.20.0</version>
</dependency>

2. 修正logback配置的类路径 #

你之前配置的类路径ch.qos.logback.core.rolling.S3FixedWindowRollingPolicy是错误的，正确路径为第三方库的包路径，同时建议避免硬编码AWS密钥，改用IAM角色、环境变量等安全方式：

<rollingPolicy class="com.github.linknv.logback.S3FixedWindowRollingPolicy">
    <fileNamePattern>${LOG_FILE}/adminServer.%d{yyyy-MM-dd}-%i.log.zip</fileNamePattern>
    <!-- 推荐使用IAM角色/环境变量替代硬编码密钥 -->
    <!-- <awsAccessKey>ACCESS_KEY</awsAccessKey> -->
    <!-- <awsSecretKey>SECRET_KEY</awsSecretKey> -->
    <s3BucketName>myapp-logging</s3BucketName>
    <s3FolderName>logs/%d{yyyy/MM/dd}</s3FolderName>
    <rolloverOnExit>true</rolloverOnExit>
    <shutdownHookType>SERVLET_CONTEXT</shutdownHookType>
    <timeBasedFileNamingAndTriggeringPolicy
        class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
        <maxFileSize>50MB</maxFileSize>
    </timeBasedFileNamingAndTriggeringPolicy>
    <maxHistory>2000</maxHistory>
    <totalSizeCap>3GB</totalSizeCap>
</rollingPolicy>

3. 验证依赖有效性 #

执行mvn dependency:tree命令检查依赖树，确认logback-s3-rolling-policy已被正确引入，且无版本冲突问题。

额外提示 #

• 若使用Spring Boot，建议搭配Spring Cloud AWS Starter管理AWS依赖，简化权限与配置流程。
• 确保应用所在环境（ECS/EC2/本地）具备访问目标S3桶的权限，避免后续出现S3访问拒绝错误。

内容的提问来源于stack exchange，提问作者BDorries