使用 HttpClient 進行表單送出時，遇到的問題

問題

在開發微信支付的小微商戶進件接口時，需要通過表單來上傳身份證圖檔等資料。在微信支付接口文檔也說明了，需要使用 multipart/form-data 的方式發送請求。.NET 提供了

MultipartFormDataContent

類型，幫助我們建構表單請求，故有以下代碼：

var form = new MultipartFormDataContent()
{
    {new StringContent("Value"),"Name},
    {new ByteArrayContent(new byte[]{}/*模拟檔案資料*/),"File,"FileName}
}
           

按照微信支付官方文檔送出之後，一直提示參數錯誤，百思不得其解。

原因

通過 Postman 模拟表單送出，捕獲資料包，将其與 C# 的送出代碼進行對比，發現了兩處問題。

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 的雙引号

使用

MultipartFormDataContent

送出的表單請求，外部

Content-Type

的

boundary

值帶有

"

号。而 Postman 送出的表單請求，它的

boudary

值是沒有雙引号的。

那為什麼會造成這樣的差異呢？參考 這篇 部落格的講解，是由于各個系統/語言針對 RFC 2046 的實作不一緻導緻的。針對于

MultipartFormDataContent

的行為，如果 Boundary 後面的值帶有雙引号是符合标準的。

RFC 2612 原文：

1. Although RFC 2046 [40] permits the boundary string to be

   quoted, some existing implementations handle a quoted boundary

   string incorrectly.

Boundary 的作用，是一個随機生成的字元串，在 HTTP 協定當中用于分割内部多個 Content。為什麼是随機生成的呢？就是防止這個分割符跟你内部的 Content 産生重複造成意外。(C# 預設使用的是 Guid 作為随機串，你也可以在構造

MultipartFormDataContent

的時候，通過其構造函數手動指定)

2. 表單内鍵值對，值的雙引号

第二個問題則是表單内的内容，他們的

name

鍵值對，其值又沒有雙引号，是以你得在添加 Content 的時候，得手動指定雙引号。

解決

兩個問題都是由于雙引号導緻的，是以隻需要在真正發起調用之前将内部的雙引号替換為空，或者将缺失的雙引号添加上即可。

針對問題一，其内部的

ContentType.Parameters

，通過 LINQ 找到

boundary

的鍵值對，替換内部的雙引号即可。

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

針對問題二，在構造内部 Content 的時候，其 Name 手動賦予雙引号。

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"}
};