如何在Rest Assured API链式调用中重置Multipart Content-type

问题核心 #

复用同一个RequestSpecification实例时，multipart请求添加的文件/表单参数会保留在实例中，后续即使修改ContentType为JSON，框架仍然会检测到残留的multipart内容，触发格式校验报错。

解决方案 #

方案1：每次请求新建独立RequestSpecification实例（最稳妥） #

不要全局复用同一个spec实例，每个请求通过RestAssured.given()创建全新实例，请求之间的配置完全隔离，不会互相污染：

// 第一个JSON接口
RestAssured.given()
  .contentType(ContentType.JSON)
  .body(firstJson)
  .when()
  .post("/api/first")
  .then()
  .statusCode(200);

// Multipart接口
RestAssured.given()
  .contentType(ContentType.MULTIPART)
  .multiPart("file", new File("test.pdf"))
  .when()
  .post("/api/upload")
  .then()
  .statusCode(200);

// 第四个JSON接口，全新实例无残留配置
RestAssured.given()
  .contentType(ContentType.JSON)
  .body(fourthJson)
  .when()
  .post("/api/fourth")
  .then()
  .statusCode(200);

方案2：复用spec时主动清理残留配置 #

如果需要保留公共配置（如统一域名、公共鉴权Header），可以在multipart请求结束后主动清理多段内容：

// 公共基础spec定义
RequestSpecification commonSpec = RestAssured.given()
  .baseUri("https://your-api.com")
  .header("Authorization", "Bearer token");

// 调用multipart接口
commonSpec
  .contentType(ContentType.MULTIPART)
  .multiPart("file", new File("test.pdf"))
  .when()
  .post("/api/upload")
  .then()
  .statusCode(200);

// 清理multipart残留
commonSpec.removeMultiPart();
// 重置ContentType为JSON
commonSpec.contentType(ContentType.JSON);

// 调用后续JSON接口
commonSpec
  .body(fourthJson)
  .when()
  .post("/api/fourth")
  .then()
  .statusCode(200);

方案3：基于基础spec衍生请求配置（推荐复用场景） #

公共基础spec仅存储通用配置，每个请求的专属配置（如ContentType、body、multipart）基于基础spec衍生，不会修改原基础spec的内容，从根源避免污染：

// 仅存储通用配置的基础spec，全程不修改
RequestSpecification baseSpec = RestAssured.given()
  .baseUri("https://your-api.com")
  .header("Authorization", "Bearer token");

// 调用JSON接口，专属配置仅对当前请求生效
given()
  .spec(baseSpec)
  .contentType(ContentType.JSON)
  .body(firstJson)
.when()
  .post("/api/first")
.then()
  .statusCode(200);

// 调用multipart接口，专属配置不影响baseSpec
given()
  .spec(baseSpec)
  .contentType(ContentType.MULTIPART)
  .multiPart("file", new File("test.pdf"))
.when()
  .post("/api/upload")
.then()
  .statusCode(200);

// 后续JSON接口直接使用baseSpec，无残留配置
given()
  .spec(baseSpec)
  .contentType(ContentType.JSON)
  .body(fourthJson)
.when()
  .post("/api/fourth")
.then()
  .statusCode(200);

注意事项 #

• removeMultiPart()方法需要Rest Assured 4.0+版本支持，低版本可以升级到最新稳定版使用
• 调用reset()方法会清空spec的所有配置（包括公共Header、域名等），适合不需要保留公共配置的场景
• 不建议直接在公共spec实例上添加请求专属的配置，避免全局污染影响后续请求

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