SpringBoot3迁移JDK17遇java.io.FileWriter类加载器不匹配问题

问题核心分析 #

你遇到的错误本质是JDK17模块系统的反射访问限制：java.io属于java.base模块，默认不对未命名模块（你的应用代码所在模块）开放反射权限，而CGLIB生成子类需要访问类的内部结构。之前添加的JVM参数针对的是java.lang包，和报错的java.io不匹配，所以无效。

具体解决方案 #

1. 修正JVM启动参数 #

将原参数替换为针对java.io包的开放指令：

--add-opens=java.base/java.io=ALL-UNNAMED

这个参数会让java.base模块把java.io包开放给所有未命名模块，允许CGLIB进行必要的反射操作。

2. 重构Spring Batch的Writer Bean（推荐最佳实践） #

直接将JDK原生的java.io.FileWriter标注为@StepScope Bean是不合理的——JDK核心类不是为Spring代理设计的。正确的做法是自定义Spring Batch的ItemWriter，内部封装FileWriter，再对自定义类应用@StepScope：

import org.springframework.batch.item.ItemWriter;
import org.springframework.batch.item.file.FlatFileItemWriter;
import org.springframework.batch.item.file.builder.FlatFileItemWriterBuilder;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Qualifier;
import org.springframework.batch.core.scope.StepScope;

@StepScope
@Bean
@Qualifier("batchFileWriter")
public ItemWriter<YourDataModel> batchFileWriter(@Value("#{jobParameters['outputPath']}") String outputPath) {
    return new FlatFileItemWriterBuilder<YourDataModel>()
            .name("dataFileWriter")
            .resource(new org.springframework.core.io.FileSystemResource(outputPath))
            .lineAggregator(data -> String.format("%s,%s", data.getId(), data.getName())) // 按需调整数据格式
            .build();
}

通过这种方式，CGLIB代理的是你自己的自定义类，不会触碰JDK核心模块的访问限制，同时也符合Spring Batch的规范。

3. 检查Gradle依赖与配置 #

确保Gradle 8.1.0与Spring Boot 3.0、JDK17的兼容性，避免依赖冲突：

• 确认build.gradle中Java版本设置为17：

java {
    sourceCompatibility = JavaVersion.VERSION_17
    targetCompatibility = JavaVersion.VERSION_17
}

• 依赖管理使用Spring Boot Starter，避免手动引入旧版本的CGLIB或Spring Batch依赖：

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-batch'
    // 其他业务依赖
}

4. 排查类加载器冲突 #

如果以上步骤无效，检查是否存在多版本依赖冲突：

• 执行./gradlew dependencies查看依赖树，确保没有引入cglib的旧版本（Spring Boot 3.0自带的CGLIB已适配JDK17）。
• 确认所有Spring相关依赖的版本与Spring Boot 3.0统一（通过io.spring.dependency-management插件自动管理）。

内容的提问来源于stack exchange，提问作者César Castro Aroche