Karate API：0.9.5可处理文件上传，1.3.0.RC1报错求助

Karate 1.x版本对multipart表单的参数绑定逻辑做了严格优化，和0.9.5的宽松处理不同：0.9.5中重复提交同名字段会被自动组装为列表，但1.x版本需要显式声明参数为列表类型，否则会被识别为单个参数，导致后端无法解析为所需的列表结构，这就是你遇到"required list parameter 'metadata' is not present"错误的核心原因。

方式1：显式声明metadata为列表参数 #

直接通过multipart块将metadata作为列表传递，完全适配1.x版本的参数解析规则：

Given url your-target-api-endpoint
And header Content-Type = 'multipart/form-data'
And multipart field metadata = [{key: 'FILE_NAME', value: 'test'}, {key: 'FILE_EXTENSION', value: 'jpg'}]
When method post
Then status 200

方式2：保留多字段提交并开启列表自动组装 #

如果想延续0.9.5中重复提交metadata字段的写法，可通过配置让Karate自动将同名字段转为列表：

Given url your-target-api-endpoint
And header Content-Type = 'multipart/form-data'
And multipart field metadata = {key: 'FILE_NAME', value: 'test'}
And multipart field metadata = {key: 'FILE_EXTENSION', value: 'jpg'}
And configure multipart = { singleParameterToList: true }
When method post
Then status 200

singleParameterToList: true配置会触发Karate将同名字段自动合并为列表，匹配后端的参数要求。

方式3：构造原生form-data格式提交 #

若上述方式仍有问题，可直接构造符合multipart规范的字符串格式表单数据：

Given url your-target-api-endpoint
And header Content-Type = 'multipart/form-data'
And form field metadata = '{"key":"FILE_NAME","value":"test"}'
And form field metadata = '{"key":"FILE_EXTENSION","value":"jpg"}'
When method post
Then status 200

注意要将每个metadata的JSON对象转为字符串，确保后端能正确解析为列表元素。

• 开启Karate请求日志（configure logPrettyRequest = true），查看生成的multipart请求结构是否与后端预期一致
• 确认后端接口确实要求metadata为列表类型，且每个元素是JSON格式的键值对

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