如何在Pact-jest中配置文件上传（multipart-form）测试的请求体？

针对你用OpenAPI Generator生成的文件上传接口，在Pact Provider测试中配置正确的multipart请求体，可按以下方案处理：

核心问题分析 #

你的生成代码中，文件通过FormData.append('file', file)添加，请求体为multipart/form-data格式，包含名为file的表单字段对应文件内容，测试时需精准匹配这一结构。

修正后的测试代码实现 #

使用multipartBody方法构建请求体，结合Pact匹配器处理动态内容（如自动生成的boundary、文件内容），无需完全匹配真实值：

new PactV4({
  consumer: 'CONSUMER',
  provider: 'PROVIDER',
  logLevel: 'debug',
})
.addInteraction()
.uponReceiving('uploading a document')
.withRequest('POST', '/document', builder => {
  builder
    // 用正则匹配任意multipart/form-data类型，忽略具体boundary值
    .headers({
      'Content-Type': MatchersV3.regex(
        /multipart\/form-data; boundary=.+/,
        'multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW'
      ),
      'Accept': 'application/json'
    })
    // 配置multipart请求体，匹配文件字段结构
    .multipartBody(
      MatchersV3.eachLike({
        name: 'file',
        filename: MatchersV3.string('test-document.pdf'), // 匹配任意文件名
        contentType: MatchersV3.string('application/pdf'), // 匹配对应文件类型
        content: MatchersV3.string(MatchersV3.anything()) // 忽略具体文件内容
      })
    );
})
.willRespondWith(200, builder => {
  builder.jsonBody(MatchersV3.like(response));
});

关键注意事项 #

• 表单字段名必须一致：要和生成代码中FormData.append('file', ...)的第一个参数file完全匹配，不能写错。
• 用匹配器处理动态值：
  • Content-Type的boundary是客户端自动生成的，用正则匹配器忽略具体值，只校验格式。
  • 文件内容无需真实数据，用MatchersV3.anything()匹配任意内容即可。
  • 文件名和contentType可根据实际场景调整匹配规则，比如允许任意文件名或特定后缀。
• 禁止硬编码boundary：真实请求的boundary每次都不同，硬编码会导致测试失败。

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