Spring Boot 3迁移后GitLab流水线测试失败求助

问题背景 #

已完成从Spring Boot 2.3到3.0的迁移，同步升级Java从1.8到17、Gradle从5.6到7.6。单元测试和BDD测试在本地运行正常，但在GitLab流水线执行时失败，报错如下（当前仍使用JUnit 4）：

java.lang.IllegalStateException at DefaultCacheAwareContextLoaderDelegate.java:142
        Caused by: java.lang.IllegalArgumentException at FileUtils.java:90

执行的Gradle命令：./gradlew check jacocoRootReport --stacktrace

已尝试的无效方案：

• 迁移至JUnit 5
• 升级WireMock到2.35版本
• 在测试类添加@DirtyContext（原描述中@DeritiesContex为笔误）

排查与解决建议 #

1. 对齐GitLab Runner与本地环境 #

• 确认Runner的Java版本为17，排查是否存在多Java版本冲突；优先使用项目根目录的gradlew执行，避免依赖系统全局Gradle版本
• 检查Runner工作目录的文件读写权限，FileUtils异常大概率和路径解析、文件权限相关，比如测试临时文件无法创建/读取

2. 定位FileUtils异常的具体原因 #

• 查看完整堆栈追踪，明确FileUtils.java:90处的具体操作（如路径拼接、文件创建），确认是否存在相对路径在流水线环境中解析异常
• 检查测试是否依赖本地存在但流水线缺失的文件/目录（比如自定义配置文件、本地测试资源）
• 测试中若使用临时目录，显式指定可读写的路径，避免依赖系统默认临时目录的权限限制

3. 解决Spring上下文缓存冲突 #

• 若保留JUnit 4，确保所有测试类的Spring上下文配置一致；@DirtyContext需确认作用范围（类/方法）是否覆盖了上下文污染的场景
• 流水线中测试并行执行可能触发上下文缓存异常，尝试添加参数禁用缓存：./gradlew check jacocoRootReport --stacktrace --no-build-cache --no-test-cache

4. 排除Jacoco的干扰 #

• 先单独执行./gradlew check --stacktrace，确认是否是Jacoco报告生成环节导致的问题
• 升级Jacoco到兼容Spring Boot 3.0与Java 17的最新版本，避免版本兼容问题

5. 检查测试代码中的硬编码问题 #

• 排查测试代码中是否存在硬编码的本地文件路径（如/home/user/test），这类路径在流水线环境中不存在
• 验证测试资源文件是否被正确打包到测试jar中，确保流水线执行时可以正常读取

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