快捷導(dǎo)航

springboot實(shí)現(xiàn)postman中form-data傳參實(shí)現(xiàn)過(guò)程

更新時(shí)間：2026年04月02日 09:26:49 作者：濤哥是個(gè)大帥比

在項(xiàng)目場(chǎng)景開發(fā)中,對(duì)接需求要求使用POST請(qǐng)求傳form-data數(shù)據(jù),使用HttpClient請(qǐng)求時(shí)遇到了415錯(cuò)誤,后改為restTemplate,封裝參數(shù)時(shí)使用LinkedMultiValueMap對(duì)象以解決參數(shù)無(wú)法正確解析的問(wèn)題

項(xiàng)目場(chǎng)景

開發(fā)中遇到對(duì)接需求時(shí)候，被要求用post請(qǐng)求傳form-data數(shù)據(jù)的時(shí)候一臉懵逼，在postman中可以調(diào)用，但是程序中怎么調(diào)用呢。

問(wèn)題描述

在postman中調(diào)用是沒問(wèn)題的

但是在程序中調(diào)用就報(bào)錯(cuò)了，之前用的是HttpClient的方式請(qǐng)求的

public StringBuffer caller(Map<String,String> map, String strURL) {
        // start
        HttpClient httpClient = new HttpClient();
 
        HttpConnectionManagerParams managerParams = httpClient
                .getHttpConnectionManager().getParams();
        // 設(shè)置連接超時(shí)時(shí)間(單位毫秒)
        managerParams.setConnectionTimeout(30000);
        // 設(shè)置讀數(shù)據(jù)超時(shí)時(shí)間(單位毫秒)
        managerParams.setSoTimeout(120000);
 
        PostMethod postMethod = new PostMethod(strURL);
        // 將請(qǐng)求參數(shù)的值放入postMethod中
        String strResponse = null;
        StringBuffer buffer = new StringBuffer();
        // end
        try {
            //設(shè)置參數(shù)到請(qǐng)求對(duì)象中
            for(String key : map.keySet()){
                postMethod.addParameter(key, map.get(key));
            }
            
            int statusCode = httpClient.executeMethod(postMethod);
            if (statusCode != HttpStatus.SC_OK) {
                throw new IllegalStateException("Method failed: "
                        + postMethod.getStatusLine());
            }
            BufferedReader reader = null;
            reader = new BufferedReader(new InputStreamReader(
                    postMethod.getResponseBodyAsStream(), "UTF-8"));
            while ((strResponse = reader.readLine()) != null) {
                buffer.append(strResponse);
            }
        } catch (Exception ex) {
            throw new IllegalStateException(ex.toString());
        } finally {
            // 釋放連接
            postMethod.releaseConnection();
        }
        return buffer;
    }

請(qǐng)求普通的接口沒問(wèn)題，但是第三方的接口會(huì)報(bào)錯(cuò)：415 Unsupported Media Type ，很明顯是請(qǐng)求方式的問(wèn)題，然后我在請(qǐng)求頭加上了multipart/form-data，接口請(qǐng)求通了，但是報(bào)錯(cuò)參數(shù)錯(cuò)誤，也就是接口沒獲取到參數(shù)。

postMethod.setRequestHeader("Content-Type", "multipart/form-data");

原因分析

form-data主要是以鍵值對(duì)的形式來(lái)上傳參數(shù)，同時(shí)參數(shù)之間以&分隔符分開。

我就嘗試?yán)胢ap進(jìn)行數(shù)據(jù)的的封裝Map<String,String>，結(jié)果發(fā)現(xiàn)后臺(tái)無(wú)法正確解析參數(shù)，是因?yàn)閙ap封裝后并不是以&鏈接的。

解決方案

最后利用spring來(lái)作為后端框架，form-data利用LinkedMultiValueMap對(duì)象來(lái)包裝多個(gè)參數(shù)，參數(shù)以key-value形式，中間以&連接。

采用restTemplate代碼的實(shí)現(xiàn)如下：

public String caller(Map<String,String> map, String strURL){
		HttpHeaders headers = new HttpHeaders();
		MultiValueMap<String, Object> map= new LinkedMultiValueMap<>();
		headers.add("Content-Type", "multipart/form-data");
	    //設(shè)置參數(shù)到請(qǐng)求對(duì)象中
        for(String key : map.keySet()){
        	map.add(key, map.get(key));
        }
		
		HttpEntity<MultiValueMap<String, Object>> requestParams = new HttpEntity<>(map, headers);
		ResponseEntity<String> response = restTemplate.postForEntity(apiUrl,requestParams,String.class);
		String result =response.getBody();
		return result;
}

最后沒用HttpClient 的方式，改為了restTemplate的方式。