如何通过HttpClient向application/x-www-form-urlencoded发送多类型数据（Payu退款API）

核心问题说明 #

application/x-www-form-urlencoded编码格式只支持<string, string>的键值对，不管你原本的参数是float还是其他类型，都必须先转换成字符串格式再传递。直接用<string, dynamic>字典会因为类型不匹配报错，因为FormUrlEncodedContent的构造函数只接受IEnumerable<KeyValuePair<string, string>>类型的参数。

具体解决步骤 #

1. 统一参数类型为<string, string>
   把float类型的金额转换成符合Payu要求的字符串格式（比如保留两位小数，避免格式错误），其他5个字符串参数直接保留。比如金额是123.45f，转成"123.45"。

2. 正确构造请求体
   不要用StringContent序列化JSON来冒充application/x-www-form-urlencoded格式，直接用FormUrlEncodedContent传入<string, string>的键值对集合，它会自动帮你生成符合要求的编码格式。

3. 异步处理请求与响应
   避免直接用.Result阻塞线程，改用await进行异步调用，防止死锁问题。响应数据如果是JSON格式，直接反序列化成对应的模型类或者动态对象即可。

修正后的代码示例 #

// 构造<string, string>类型的参数集合
var formData = new Dictionary<string, string>
{
    {"param1", "字符串参数1"},
    {"param2", "字符串参数2"},
    {"param3", "字符串参数3"},
    {"param4", "字符串参数4"},
    {"param5", "字符串参数5"},
    {"amount", 123.45f.ToString("F2")} // float转字符串，保留两位小数
};

using (HttpClient client = new HttpClient())
{
    // 设置Accept头，告诉服务器我们接受JSON格式的响应
    client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));

    // 构造符合application/x-www-form-urlencoded格式的请求体
    var content = new FormUrlEncodedContent(formData);

    // 异步发送POST请求
    var payuResponse = await client.PostAsync(url, content);

    // 确保请求成功再处理响应
    payuResponse.EnsureSuccessStatusCode();

    // 读取响应内容并反序列化为JSON对象（可替换为你的实体类）
    var jsonResponse = await payuResponse.Content.ReadAsStringAsync();
    var responseModel = JsonConvert.DeserializeObject<YourResponseModel>(jsonResponse);
}

关键改动说明 #

• 替换<string, dynamic>字典为<string, string>，确保所有参数都是字符串类型。
• 移除错误的StringContent构造方式，改用FormUrlEncodedContent生成正确的编码格式。
• 用await替代.Result，实现异步非阻塞调用，提升代码稳定性。
• 添加EnsureSuccessStatusCode()，请求失败时抛出异常，方便排查问题。

内容的提问来源于stack exchange，提问作者MOHAMED YUSUF K