使用DIUS Pact实现multipart/form-data上传CDC测试遇边界问题求助

你在使用Pact做文件上传的消费者驱动契约测试时，遇到了multipart/form-data请求的边界（boundary）不匹配问题，导致服务端返回"Missing start boundary"错误，同时契约验证失败。我来帮你拆解问题并给出解决方案：

问题根源分析 #

1. 手动指定boundary导致不匹配：你在测试代码里手动设置了Content-Type头的boundary，但Pact生成的契约里会自动生成自己的boundary值，这就导致实际请求的boundary和契约预期的不一致，触发验证失败。
2. withFileUpload参数误用：你给withFileUpload传的Content-Type是multipart/form-data，但这个参数应该是单个文件的Content-Type（比如.gitignore是文本文件，应该用text/plain），整个请求的multipart/form-data类型是Pact自动处理的。

解决方案步骤 #

1. 修正Pact契约定义 #

调整createPact方法，让Pact自动处理multipart请求的boundary，同时修正文件的Content-Type：

@Pact(provider = PROVIDER, consumer = CONSUMER) 
public RequestResponsePact createPact(PactDslWithProvider builder) throws Exception { 
    DslPart responseBody = new PactDslJsonBody() 
        .stringType("resource", DESTINATION_FILENAME) 
        .stringType("requestId", null) 
        .stringType("code", "201") 
        .array("response") 
        .closeArray() 
        .asBody(); 

    return builder.given("UploadOperation") 
        .uponReceiving("Upload operation") 
        .path("/files/upload") 
        .matchQuery("overwrite", "true") 
        .matchQuery("destination_filename", DESTINATION_FILENAME) 
        // 修正：文件的Content-Type用text/plain，让Pact自动处理multipart的boundary
        .withFileUpload("file", ".gitignore", "text/plain", new byte[]{11,44,66,123,66}) 
        .willRespondWith() 
        .status(201) 
        .body(responseBody) 
        .toPact(); 
}

2. 修正测试请求代码 #

移除手动设置的Content-Type头，让MultipartEntityBuilder自动生成包含正确boundary的Content-Type：

@Test 
@PactVerification 
public void doTest() throws IOException { 
    String url = String.format("http://localhost:%d/files/upload?overwrite=true&destination_filename=%s", PORT, DESTINATION_FILENAME); 

    // 构建multipart请求，无需手动设置Content-Type
    HttpEntity multipart = MultipartEntityBuilder.create() 
        .setMode(HttpMultipartMode.BROWSER_COMPATIBLE) 
        .addBinaryBody("file", new byte[]{11,44,66,123,66}, ContentType.TEXT_PLAIN, ".gitignore") 
        .build(); 

    // 发送请求，不要手动添加Content-Type头
    HttpResponse response = Request.Put(url) 
        .body(multipart) 
        .execute() 
        .returnResponse(); 

    String json = EntityUtils.toString(response.getEntity()); 
    System.out.println("json=" + json); 
    JSONObject jsonObject = new JSONObject(json); 
    assertTrue(jsonObject.getString("code").equals("201")); 
    assertTrue(response.getStatusLine().getStatusCode() == 201);
}

3. 关于其他支持multipart的库 #

如果你觉得Pact处理multipart请求不够顺手，还有这些工具可以考虑：

• RestAssured：对multipart/form-data请求的支持非常友好，语法简洁，适合编写API测试（包括CDC测试的消费者侧代码）
• WireMock：可以用来模拟服务端，配合JUnit编写文件上传的集成测试，灵活度高
• Spring MockMvc：如果你用Spring生态，MockMvc处理multipart请求也很方便，适合Spring应用的测试

不过如果你的核心需求是消费者驱动契约测试，Pact仍然是最佳选择，只要修正上述用法问题就能解决当前的错误。

内容的提问来源于stack exchange，提问作者Valeriy K.