如何在两个 REST API 之间转发文件上传请求-java教程-PHP中文网

如何在两个 REST API 之间转发文件上传请求

本文详解如何将一个 rest api 接收到的文件（如 multipart/form-data）作为客户端，完整、可靠地转发至另一个 rest api，涵盖主流 http 客户端选型、核心实现逻辑及关键注意事项。

本文详解如何将一个 rest api 接收到的文件（如 multipart/form-data）作为客户端，完整、可靠地转发至另一个 rest api，涵盖主流 http 客户端选型、核心实现逻辑及关键注意事项。

在微服务架构或 API 网关场景中，常需将前端上传的文件（如图片、PDF）由入口 API 接收后，不落地存储，而是直接以原始二进制流或标准 multipart 形式转发至下游业务 API。这本质上是将当前服务作为 HTTP 客户端，透传文件请求，而非先解析再重建。

✅ 核心思路：服务即客户端

尽管你的服务本身是一个 REST API（接收 POST /upload），但向目标 API（如 POST https://api.backend.com/v1/files）发起请求时，它只是标准的 HTTP 客户端角色。因此，无需特殊框架支持，只需选用成熟、支持 multipart 文件上传的 HTTP 客户端库即可。

? 推荐 HTTP 客户端选型与示例

1. Apache HttpClient（Java，企业级首选）

功能完备、线程安全、支持连接池与重试。适用于高并发生产环境。

import org.apache.http.HttpResponse;
import org.apache.http.client.methods.CloseableHttpResponse;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.entity.mime.MultipartEntityBuilder;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;

public void forwardFileToBackend(MultipartFile file, String targetUrl) throws IOException {
    try (CloseableHttpClient client = HttpClients.createDefault()) {
        HttpPost post = new HttpPost(targetUrl);

        MultipartEntityBuilder builder = MultipartEntityBuilder.create();
        builder.addBinaryBody("file", file.getBytes(), 
                              ContentType.APPLICATION_OCTET_STREAM, 
                              file.getOriginalFilename());
        // 如需透传其他字段（如 metadata），可追加：
        // builder.addTextBody("userId", "123", ContentType.TEXT_PLAIN);

        post.setEntity(builder.build());
        try (CloseableHttpResponse response = client.execute(post)) {
            int statusCode = response.getStatusLine().getStatusCode();
            if (statusCode != 200 && statusCode != 201) {
                throw new RuntimeException("Forward failed: " + statusCode);
            }
        }
    }
}

2. OkHttp（轻量高效，Kotlin/Java 通用）

API 简洁，内置连接复用与拦截器，适合对性能敏感场景。

Wordpress REST API

OpenClaw技能，提供WordPress REST API命令行工具，支持通过原生HTTP处理文章、页面、分类、标签、用户及自定义请求。

下载

val client = OkHttpClient()
val requestBody = MultipartBody.Builder()
    .setType(MultipartBody.FORM)
    .addFormDataPart("file", file.originalFilename, 
                     RequestBody.create(file.bytes, MediaType.get("application/octet-stream")))
    .build()

val request = Request.Builder()
    .url("https://api.backend.com/v1/files")
    .post(requestBody)
    .build()

client.newCall(request).execute().use { response ->
    if (!response.isSuccessful) throw IOException("Forward failed: ${response.code}")
}

3. MgntUtils HttpClient（极简入门选项）

由开发者 Michael Gantman 维护，API 极其简洁，适合快速验证或低复杂度场景：

HttpClient httpClient = new HttpClient();
Map<string object> params = new HashMap();
params.put("file", new File("path/to/uploaded/file.pdf")); // 或 byte[] / InputStream
HttpResponse response = httpClient.post("https://api.backend.com/v1/files", params);
if (response.getStatusCode() >= 400) {
    throw new RuntimeException("Forward failed: " + response.getBodyAsString());
}</string>

✅ Maven 引入：com.github.michaelgantmanMgntUtils1.5.2.3

⚠ 关键注意事项

禁止文件落地：若仅需转发，应直接读取 MultipartFile.getInputStream() 或 byte[]，避免写磁盘造成 I/O 开销与临时文件清理风险。
保持 Content-Type 一致性：确保下游 API 支持相同的 multipart/form-data 格式，并正确命名表单字段（如 file）。
超时与错误处理：务必设置连接/读取超时（如 OkHttp 的 callTimeout(30, SECONDS)），并捕获网络异常、HTTP 错误码（4xx/5xx），避免上游请求挂起。
流式转发（高级）：对于超大文件（>100MB），建议使用流式代理（如 Spring WebFlux 的 WebClient 或 Netty），避免内存溢出。
安全与鉴权：转发请求中需携带必要的认证头（如 Authorization: Bearer xxx）和自定义 Header（如 X-Request-ID, X-Forwarded-For）。

✅ 总结

文件转发本质是「服务端 HTTP 客户端编程」。选择 Apache HttpClient（稳健）、OkHttp（轻快）或 MgntUtils（极简）均可高效实现。核心在于正确构造 multipart 请求体、妥善管理资源、并做好容错设计。只要遵循 HTTP 协议规范，即可实现零感知、低延迟的跨 API 文件透传。