使用@WebMvcTest的Spring Boot测试在Atlassian Bitbucket Pipeline中失败

我之前也碰到过类似的跨环境测试失败的问题，大概率是Bitbucket Pipeline的运行环境和你本地环境存在差异，或者测试代码里有一些在本地被隐式兼容的小问题。结合你给出的Spring Boot 1.5.8 + Gradle 4.6的技术栈，给你几个具体的排查方向：

先明确问题场景 #

你本地运行以下测试代码完全正常：

@RunWith(SpringRunner.class)
@WebMvcTest(VZNFCController.class)
public class VZNFCControllerTest {
    private VZNFCTagAction action1 = new VZNFCTagAction();
    private VZNFCTagAction action2 = new VZNFCTagAction();
    
    @Before
    public void setUp(){
        action1.setMessage("message1");
        action2.setMessage("message2");
    }
    
    @Autowired
    private MockMvc mvc;
    
    @MockBean
    private VZNFCTagActionRepository actionRepository;
    
    // 剩余测试代码...
}

但在Bitbucket Pipeline中执行时测试失败。

排查方向1：环境依赖与版本一致性 #

本地和Pipeline的运行环境差异是最常见的原因：

• JDK版本：Spring Boot 1.5.8官方推荐使用JDK 8，你需要确保Bitbucket Pipeline使用的是同版本JDK。可以在bitbucket-pipelines.yml里明确指定镜像：

  image: openjdk:8-jdk
  pipelines:
    default:
      - step:
          script:
            - ./gradlew test
  

• Gradle缓存问题：Pipeline的依赖缓存可能存在脏数据，导致依赖拉取不全。可以在测试命令前加上清理缓存的操作：

  script:
    - ./gradlew clean test --no-build-cache
  

排查方向2：MockBean的初始化与配置 #

你的测试里用了@MockBean注解的VZNFCTagActionRepository，如果Controller的方法依赖这个Repository的返回值，而你没有在测试里正确mock对应的方法，本地可能因为某些上下文的隐式初始化掩盖了问题，但Pipeline的测试环境更严格。比如你需要在测试方法里添加mock逻辑：

@Test
public void testTagActionEndpoint() throws Exception {
    // 模拟Repository的返回值
    Mockito.when(actionRepository.findAll()).thenReturn(Arrays.asList(action1, action2));
    
    // 执行MockMvc请求并断言结果
    mvc.perform(get("/nfc/tags"))
       .andExpect(status().isOk())
       .andExpect(jsonPath("$[0].message").value("message1"));
}

排查方向3：Pipeline资源限制 #

Bitbucket Pipeline默认的内存配置可能不足以支撑Spring上下文的初始化，导致OOM或者初始化失败。你可以通过设置Gradle的JVM参数增加内存：

step:
  script:
    - export GRADLE_OPTS="-Xmx1024m"
    - ./gradlew test

排查方向4：查看详细失败日志 #

最直接的方式是获取Pipeline里测试失败的具体异常信息。你可以在Gradle命令里加上--info参数输出详细日志，这样就能看到到底是Bean创建失败、依赖缺失还是断言不通过：

script:
  - ./gradlew test --info

根据日志里的具体错误提示，就能快速定位问题根源了。

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