本文介绍一种可复用的 RestAssured 工具方法，通过可变参数（varargs）接收成对的 key-value，自动链式添加多个 .multiPart()，从而避免为不同测试重复编写 multipart 配置代码。
本文介绍一种可复用的 restassured 工具方法，通过可变参数（varargs）接收成对的 key-value，自动链式添加多个 `.multipart()`，从而避免为不同测试重复编写 multipart 配置代码。
在使用 RestAssured 进行 API 测试时，当多个接口需以 multipart/form-data 方式上传动态数量的表单字段（如 key1=value1, key2=value2 等），若为每个测试单独硬编码 .multiPart("key", "value")，将导致大量重复、难以维护的代码。理想方案是封装一个通用方法，支持任意数量的键值对，并统一注入到请求中。
以下是一个高内聚、低耦合的解决方案：定义静态辅助方法 buildMultiParts()，接受按顺序排列的字符串数组（"key1", "value1", "key2", "value2", ...），内部校验参数个数为偶数后，逐对解析并调用 specification.multiPart(key, value)，最终返回已预置 multipart 的 RequestSpecification 实例。
import static io.restassured.config.EncoderConfig.encoderConfig;
import static io.restassured.RestAssured.given;
import io.restassured.RestAssured;
import io.restassured.http.ContentType;
import io.restassured.specification.RequestSpecification;
public class MultiPartUtils {
/**
* 构建含多个 multipart 字段的 RequestSpecification
* @param keyValues 成对出现的 key 和 value 字符串，如 ("name", "John", "file", "test.txt")
* @return 已添加所有 multipart 的 RequestSpecification
*/
public static RequestSpecification buildMultiParts(String... keyValues) {
if (keyValues.length % 2 != 0) {
throw new IllegalArgumentException("Multipart key-value pairs must be even. Got " + keyValues.length + " arguments.");
}
RequestSpecification spec = given();
for (int i = 0; i <p><strong>使用示例：</strong></p><div class="aritcle_card flexRow artxards">
<div class="artcardd flexRow">
<a class="aritcle_card_img" rel="nofollow" href="/ai/2346" title="NatAgent"><img
src="https://img.php.cn/upload/ai_manual/001/246/273/176006639153567.png" alt="NatAgent" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a rel="nofollow" href="/ai/2346" title="NatAgent" class="overflowclass">NatAgent</a>
<p class="overflowclass">一款AI数据处理工具，主要用于AI数据情报监测与分析平台，适合需要提升相关任务效率的用户。</p>
</div>
<a rel="nofollow" href="/ai/2346" title="NatAgent" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
</a>
</div>
</div><pre class="brush:php;toolbar:false;">// test1 场景：3 个字段
Response response1 = MultiPartUtils.buildMultiParts("key1", "value1", "key2", "value2", "key3", "value3")
.urlEncodingEnabled(true)
.config(RestAssured.config()
.encoderConfig(encoderConfig().encodeContentTypeAs("multipart/form-data", ContentType.TEXT)))
.contentType(ContentType.JSON)
.headers("X-Auth", "token123")
.post("/upload");
// test2 场景：2 个字段
Response response2 = MultiPartUtils.buildMultiParts("key1", "value1", "key2", "value2")
.urlEncodingEnabled(true)
.config(RestAssured.config()
.encoderConfig(encoderConfig().encodeContentTypeAs("multipart/form-data", ContentType.TEXT)))
.contentType(ContentType.JSON)
.headers("X-Auth", "token456")
.post("/upload");
// test3 场景：5 个字段 —— 完全无侵入式扩展
Response response3 = MultiPartUtils.buildMultiParts(
"key1", "value1",
"key2", "value2",
"key3", "value3",
"key4", "value4",
"key5", "value5")
.urlEncodingEnabled(true)
.config(RestAssured.config()
.encoderConfig(encoderConfig().encodeContentTypeAs("multipart/form-data", ContentType.TEXT)))
.contentType(ContentType.JSON)
.headers("X-Auth", "token789")
.post("/upload");✅ 关键优势：
- ✅ 类型安全 & 编译期检查：无需 JSON/Map 解析，纯字符串传参，IDE 可提示、无运行时解析异常；
- ✅ 零反射、零依赖：仅基于 RestAssured 原生 API，兼容所有版本（≥4.x）；
- ✅ 链式友好：返回 RequestSpecification，可无缝衔接 .header(), .cookie(), .post() 等后续调用；
- ✅ 强校验机制：自动拦截奇数参数，避免静默错误或错位绑定（如 "key1", "val1", "val2" 导致 key2=“val2”被误设）。
⚠️ 注意事项：
- 若需上传文件（而非纯文本），请改用 multiPart(String controlName, File file) 或 multiPart(String controlName, byte[] bytes, String fileName) 重载方法，本工具暂不覆盖文件场景；
- contentType(ContentType.JSON) 与 multipart/form-data 并存时，RestAssured 会以 multipart 为主导（HTTP Content-Type 自动设为 multipart/form-data; boundary=xxx），JSON 设置在此类请求中通常被忽略，建议移除或仅用于调试上下文；
- 如需自定义 MIME 类型或字符集，可通过 multiPart(String, Object, ContentType) 重载进一步扩展该工具方法。
通过此设计，你只需维护一份核心逻辑，即可支撑任意组合的 multipart 表单测试，大幅提升测试代码的可读性、可维护性与复用率。
