You need to enable JavaScript to run this app. 如何使用HttpURLConnection在POST请求中同时发送JSON数据与CSV文件
优惠活动
大模型
产品
解决方案
定价
更多

如何使用HttpURLConnection在POST请求中同时发送JSON数据与CSV文件

用原生HttpURLConnection实现同时传JSON与CSV的POST请求

认知误区澄清

你之前了解的“HttpURLConnection单次请求仅可发送一种类型数据”是对简单请求场景的刻板印象。当接口需要同时传输结构化文本、文件时,对应的请求规范是multipart/form-data格式,HttpURLConnection本身支持自定义格式的请求流输出,完全可以依托Java原生能力实现需求,既不需要依赖第三方HTTP客户端库,也不需要通过ProcessBuilder调用curl命令。

目标请求的结构拆解

你提供的curl调用本质是标准的multipart/form-data类型POST请求,所有传输内容可以拆分为以下独立部分:

  • 自定义请求头:携带鉴权信息aToken: 你的实际Token值
  • 文本表单字段:字段名为json,值为指定结构的JSON字符串
  • 文件表单字段:字段名为file,内容为本地CSV文件的二进制流
  • 请求目标地址:https://the.api.com/api/23/postData

原生实现核心逻辑

整个实现不需要引入任何外部依赖,核心流程分为3步:

  1. 初始化HttpURLConnection实例,设置POST请求方法,开启输出流权限,手动指定Content-Type头为multipart/form-data并附带自定义的内容分隔符(分隔符是用来区分请求体内不同字段块的随机标识,避免和实际内容重复即可)
  2. 按照multipart/form-data的规范,依次把JSON文本字段、CSV文件的内容按分隔符的边界拼接写入连接的输出流
  3. 写入请求体结束标记,刷新输出流,后续按照标准方式读取接口返回的响应内容即可

下面是对应的核心实现代码,完全匹配你给出的curl请求逻辑:

// 生成分隔符(生产环境可替换为随机UUID,降低内容冲突概率)
String boundary = "----FormBoundary" + System.currentTimeMillis();
URL requestUrl = new URL("https://the.api.com/api/23/postData");
HttpURLConnection connection = (HttpURLConnection) requestUrl.openConnection();
try {
    // 连接基础配置
    connection.setRequestMethod("POST");
    connection.setDoOutput(true);
    connection.setDoInput(true);
    connection.setUseCaches(false);
    // 设置鉴权头
    connection.setRequestProperty("aToken", "替换为你的实际Token");
    // 设置请求类型与分隔符
    connection.setRequestProperty("Content-Type", "multipart/form-data; boundary=" + boundary);

    // 写请求体
    try (DataOutputStream out = new DataOutputStream(connection.getOutputStream())) {
        // 写入JSON文本字段
        out.writeBytes("--" + boundary + "\r\n");
        out.writeBytes("Content-Disposition: form-data; name=\"json\"\r\n\r\n");
        String jsonStr = "{\"project\": \"1234\", \"template\": \"5678\",\"data\":[{\"date\": \"2017-05-26\",\"place\": \"my house\"}, {\"person\":\"alice\"}]}";
        out.write(jsonStr.getBytes(StandardCharsets.UTF_8));
        out.writeBytes("\r\n");

        // 写入CSV文件字段
        File csvFile = new File("path/to/file.csv");
        out.writeBytes("--" + boundary + "\r\n");
        out.writeBytes("Content-Disposition: form-data; name=\"file\"; filename=\"" + csvFile.getName() + "\"\r\n");
        out.writeBytes("Content-Type: text/csv\r\n\r\n");
        // 分块读文件写入,避免大文件OOM
        try (FileInputStream fis = new FileInputStream(csvFile)) {
            byte[] buffer = new byte[4096];
            int readCount;
            while ((readCount = fis.read(buffer)) != -1) {
                out.write(buffer, 0, readCount);
            }
        }
        out.writeBytes("\r\n");

        // 写入请求体结束标记
        out.writeBytes("--" + boundary + "--\r\n");
        out.flush();
    }

    // 读取响应逻辑:后续可通过connection.getResponseCode()获取状态码,根据状态码读取对应输入流的返回内容
} finally {
    connection.disconnect();
}

实现注意事项

  • 严格按照RFC规范拼接multipart格式即可,不需要依赖JDK内部非公开的网络API,跨JDK版本的兼容性有保障
  • 大文件传输时使用分块读取写入的逻辑,不要一次性把整个文件加载到内存,避免触发OOM
  • 所有文本内容统一使用UTF-8编码写入,避免中文乱码
  • 该实现完全依托Java标准库能力,不会出现调用系统curl命令时因环境差异导致的命令缺失、路径不兼容问题

内容的提问来源于stack exchange,提问作者mrcrag

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.04 23:36:00