利用Hutool 的HttpUtil发送post请求

本文档展示了使用Hutool库进行HTTP POST请求时，不同方式传递参数的效果。重点讨论了为何第三种方式（Map类型参数）导致请求失败，原因是Map转换后的格式不符合接口要求。正确做法是将参数作为JSON字符串传递，确保数据合法性。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

接口提供方是一个C语言项目，该项目提供人脸抓拍与识别算法，对外开放接口，如下图中的人脸抓拍接口，接口功能：

获取任务ID为1的符合时间段的抓拍记录。接口字段定义如图：
在这里插入图片描述

package com.provy.guard.api;

import java.util.HashMap;
import java.util.Map;

import cn.hutool.http.HttpUtil;
import cn.hutool.json.JSONObject;
import cn.hutool.json.JSONUtil;

/**
 * Hutool工具里，POST方法，body中传参的几种调用方法
 * @author 架构师小跟班 www.jiagou1216.com
 *
 */
public class Test {

    public static void main(String[] args) {
        post1();// 成功
        post2();// 成功
        post3();// 失败
        post4();// 成功
    }

    public static void post1() {
        String param = "{\"StartTime\":\"2018-10-10 09:42:02\",\"EndTime\":\"2018-10-29 09:42:02\",\"StartIndex\":\"0\",\"PageSize\":\"30\"}";
        String result = HttpUtil.post("http://localhost:8080/v1/hitrecord/2", param);
        System.out.println(result);
    }

    public static void post2() {
        JSONObject param = JSONUtil.createObj();
        param.put("StartTime", "2018-10-10 09:42:02");
        param.put("EndTime", "2018-10-29 09:42:02");
        param.put("StartIndex", 0);
        param.put("PageSize", 30);
        String result = HttpUtil.post("http://localhost:8080/v1/hitrecord/2", param.toString());
        System.out.println(result);
    }

    public static void post3() {
        Map<String, Object> param = new HashMap<String, Object>();
        param.put("StartTime", "2018-10-10 09:42:02");
        param.put("EndTime", "2018-10-29 09:42:02");
        param.put("StartIndex", "0");
        param.put("PageSize", "30");
        String result = HttpUtil.post("http://localhost:8080/v1/hitrecord/2", param);
        System.out.println(result);
    }

    public static void post4() {
        JSONObject json = JSONUtil.createObj();
        String result = HttpUtil.createPost("http://localhost:8080/v1/hitrecord/2").body(json).execute().body();
        System.out.println(result);
    }

}

很多人问为什么3会失败？

因为数据不合法

先说hutool为什么不行？

hutool的传的map是拼接再表单上的
在这里插入图片描述
所以我们得传字符串

其他工具发送

这是因为Map转成字符串了，并不是像示例1那样({“StartTime”:"2018-10-10 09:42:02)
而是像({a:123,b:1234})，这样是不合法的，所以传不过去。