問題#

在開發(fā)微信支付的小微商戶進(jìn)件接口時(shí)，需要通過表單來上傳身份證圖片等數(shù)據(jù)。在微信支付接口文檔也說明了，需要使用 multipart/form-data 的方式發(fā)送請(qǐng)求。.NET 提供了 MultipartFormDataContent 類型，幫助我們構(gòu)建表單請(qǐng)求，故有以下代碼：

var form = new MultipartFormDataContent()
{
  {new StringContent("Value"),"Name},
  {new ByteArrayContent(new byte[]{}/*模擬文件數(shù)據(jù)*/),"File,"FileName}
}

按照微信支付官方文檔提交之后，一直提示參數(shù)錯(cuò)誤，百思不得其解。

原因#

通過 Postman 模擬表單提交，捕獲數(shù)據(jù)包，將其與 C# 的提交代碼進(jìn)行對(duì)比，發(fā)現(xiàn)了兩處問題。

Postman 的原始提交：

POST http://api.mch.weixin.qq.com/secapi/mch/uploadmedia HTTP/1.1
User-Agent: PostmanRuntime/7.21.0
Accept: */*
Cache-Control: no-cache
Postman-Token: b6800c0f-3f16-4981-b661-e6d16fc1bb1e
Host: api.mch.weixin.qq.com
Content-Type: multipart/form-data; boundary=--------------------------639275760242036520206377
Accept-Encoding: gzip, deflate
Content-Length: 566
Connection: keep-alive

----------------------------639275760242036520206377
Content-Disposition: form-data; name="mch_id"

1565111111
----------------------------639275760242036520206377
Content-Disposition: form-data; name="media_hash"

7215E92A8F3F3D0256484EFFF53A25F6
----------------------------639275760242036520206377
Content-Disposition: form-data; name="sign_type"

HMAC-SHA256
----------------------------639275760242036520206377
Content-Disposition: form-data; name="sign"

A1D8B094FA24BE5531D1AC198DE25550
----------------------------639275760242036520206377--

C# 代碼的提交：

POST http://api.mch.weixin.qq.com/secapi/mch/uploadmedia HTTP/1.1
Host: api.mch.weixin.qq.com
Content-Type: multipart/form-data; boundary="e9d5712f-7923-4ec5-8bf3-c8d5d3cd3217"
Content-Length: 502

--e9d5712f-7923-4ec5-8bf3-c8d5d3cd3217
Content-Type: text/plain; charset=utf-8
Content-Disposition: form-data; name=mch_id

--e9d5712f-7923-4ec5-8bf3-c8d5d3cd3217
Content-Type: text/plain; charset=utf-8
Content-Disposition: form-data; name=media_hash

33F15BC2D17D6FFBC18FA566EF65722E
--e9d5712f-7923-4ec5-8bf3-c8d5d3cd3217
Content-Type: text/plain; charset=utf-8
Content-Disposition: form-data; name=sign

1E377684F9BD583D2ED26FB367916C0C
--e9d5712f-7923-4ec5-8bf3-c8d5d3cd3217--

1. Boundary 的雙引號(hào)

使用 MultipartFormDataContent 提交的表單請(qǐng)求，外部 Content-Type 的 boundary 值帶有 " 號(hào)。而 Postman 提交的表單請(qǐng)求，它的 boudary 值是沒有雙引號(hào)的。

那為什么會(huì)造成這樣的差異呢？參考 這篇 博客的講解，是由于各個(gè)系統(tǒng)/語言針對(duì) RFC 2046 的實(shí)現(xiàn)不一致導(dǎo)致的。針對(duì)于 MultipartFormDataContent 的行為，如果 Boundary 后面的值帶有雙引號(hào)是符合標(biāo)準(zhǔn)的。

RFC 2612 原文：

2) Although RFC 2046 [40] permits the boundary string to be
quoted, some existing implementations handle a quoted boundary
string incorrectly.

Boundary 的作用，是一個(gè)隨機(jī)生成的字符串，在 HTTP 協(xié)議當(dāng)中用于分割內(nèi)部多個(gè) Content。為什么是隨機(jī)生成的呢？就是防止這個(gè)分割符跟你內(nèi)部的 Content 產(chǎn)生重復(fù)造成意外。(C# 默認(rèn)使用的是 Guid 作為隨機(jī)串，你也可以在構(gòu)造 MultipartFormDataContent 的時(shí)候，通過其構(gòu)造函數(shù)手動(dòng)指定)

2. 表單內(nèi)鍵值對(duì)，值的雙引號(hào)

第二個(gè)問題則是表單內(nèi)的內(nèi)容，他們的 name 鍵值對(duì)，其值又沒有雙引號(hào)，所以你得在添加 Content 的時(shí)候，得手動(dòng)指定雙引號(hào)。

解決#

兩個(gè)問題都是由于雙引號(hào)導(dǎo)致的，所以只需要在真正發(fā)起調(diào)用之前將內(nèi)部的雙引號(hào)替換為空，或者將缺失的雙引號(hào)添加上即可。

針對(duì)問題一，其內(nèi)部的 ContentType.Parameters ，通過 LINQ 找到 boundary 的鍵值對(duì)，替換內(nèi)部的雙引號(hào)即可。

var boundaryValue = form.Headers.ContentType.Parameters.Single(p => p.Name == "boundary");
boundaryValue.Value = boundaryValue.Value.Replace("\"", String.Empty);

針對(duì)問題二，在構(gòu)造內(nèi)部 Content 的時(shí)候，其 Name 手動(dòng)賦予雙引號(hào)。

var form = new MultipartFormDataContent
{
  {new StringContent(mchId), "\"mch_id\""},
  {new ByteArrayContent(bytes), "media", $"\"{HttpUtility.UrlEncode(Path.GetFileName(imagePath))}\""},
  {new StringContent(mediaHash), "\"media_hash\""},
  {new StringContent(sign), "sign"}
};

以上就是本文的全部?jī)?nèi)容，希望對(duì)大家的學(xué)習(xí)有所幫助，也希望大家多多支持我們。