Bitbucket Pipeline构建失败排查：本地正常但流水线测试失败

环境层面差异 #

• JDK/JRE版本不一致：本地使用的Java版本可能和流水线容器中的版本不同，部分测试用例可能对特定Java版本有依赖
• Maven版本差异：本地Maven版本与流水线中配置的版本不匹配，surefire插件的行为可能随Maven版本变化
• 系统环境变量/配置：流水线容器中的环境变量（如JAVA_HOME、MAVEN_OPTS）和本地设置不同，可能影响测试执行

依赖与缓存层面差异 #

• 依赖拉取差异：本地已缓存的依赖在流水线中可能重新拉取，存在版本不一致或镜像源差异（比如本地用国内镜像，流水线用官方仓库）
• SNAPSHOT依赖更新：本地的SNAPSHOT依赖可能是旧版本，而流水线拉取了最新的SNAPSHOT包，导致测试不兼容

测试执行上下文差异 #

• 测试环境资源缺失：本地可能有额外的服务（如数据库、Redis）或配置文件，流水线中未启动这些依赖服务，导致测试失败
• 用户权限不同：流水线容器以特定用户运行，本地以当前用户运行，部分测试涉及文件读写、权限操作时会出现差异
• 无头环境限制：如果测试涉及GUI操作（如Selenium），流水线的无头环境没有图形界面，会导致测试失败

代码与配置同步问题 #

• 未提交的本地修改：本地有未提交到仓库的代码或配置变更，流水线拉取的是仓库中的代码，两者不一致
• 流水线配置遗漏：bitbucket-pipelines.yml中未正确配置测试所需的前置步骤（如初始化数据库、加载配置文件）

插件与配置差异 #

• surefire插件配置生效差异：本地pom.xml可能有自定义的surefire配置（如跳过某些测试、指定测试类），但流水线中可能未生效，或者配置被覆盖
• 测试日志截断：流水线中测试失败的详细日志被截断，需要在bitbucket-pipelines.yml中配置完整的日志输出，才能定位具体失败的测试用例

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