Micronaut HttpClient：如何使用 MultipartBody 避免 MultipartException 发送 Multipart 请求？

Micronaut Httpclient：如何使用 MultipartBody 发送 Multipart 请求

引言

在 Micronaut 框架中，使用 HttpClient 发送 multipart 请求时，你需要确保请求体正确包含文件部分和元数据部分。使用字符串作为 multipart 请求体的文件部分可能会引发 MultipartException 错误，阻碍你的请求发送。

问题：字符串文件部分导致 MultipartException

当你使用字符串作为 multipart 请求体的文件部分时，Httpclient 无法将其识别为有效的文件。它期待一个符合 RFC 2046 格式的文件部分，其中包含文件名、MIME 类型和文件内容。

解决方法：使用 MultipartBody

为了解决此问题，Micronaut 提供了 MultipartBody 类，它允许你构建符合 RFC 2046 格式的 multipart 请求体。MultipartBody 允许你指定文件部分的名称、文件名、MIME 类型和文件内容。

步骤：

1. 创建 MultipartBody： 使用 MultipartBody 类的构建器方法，添加文件部分和元数据部分，每个部分包含名称、文件名、MIME 类型和内容。

2. 发送请求： 将 MultipartBody 设置为 HTTP 请求的正文，并确保设置 Content-Type 标头为 multipart/form-data，并指定 multipart 请求体的分隔符（body.getBoundary()）。

示例代码：

MultipartBody body = MultipartBody.builder()
    .addPart("file", "sample_file.jpeg", "image/jpeg", <file bytes>)
    .addPart("metadata", "metadata.json", "application/json", <metadata>)
    .build();

HttpRequest<?> request =
        HttpRequest.create( <url> )
            .body(body)
            .header(AUTHORIZATION,
                "Bearer ")
            .header(HttpHeaders.CONTENT_TYPE, "multipart/form-data;boundary=" + body.getBoundary());

String responseBody = httpClient.toBlocking().retrieve(request);

结论

通过使用 MultipartBody 构建 multipart 请求体，你可以避免 MultipartException 错误，并成功发送包含文件部分和元数据部分的 multipart 请求。

常见问题解答

1. 为什么需要使用 MultipartBody？

   • MultipartBody 允许你构建符合 RFC 2046 格式的 multipart 请求体，其中包含文件部分的名称、文件名、MIME 类型和文件内容。

2. 如何创建 MultipartBody？

   • 使用 MultipartBody 类的构建器方法，为每个文件部分和元数据部分指定名称、文件名、MIME 类型和内容。

3. 如何将 MultipartBody 用作 HTTP 请求的正文？

   • 将 MultipartBody 设置为 HTTP 请求的正文，并确保设置 Content-Type 标头为 multipart/form-data，并指定 multipart 请求体的分隔符（body.getBoundary()）。

4. 如果我不使用 MultipartBody 会怎样？

   • 如果你使用字符串作为文件部分，可能会引发 MultipartException 错误，因为 Httpclient 无法将其识别为有效的文件。

5. MultipartBody 支持哪些 MIME 类型？

   • MultipartBody 支持所有有效的 MIME 类型，包括图像、音频、视频、文本和其他类型的文件。