C#中如何向HttpClient.PostAsync传递嵌套参数

你之前用FormUrlEncodedContent传递普通键值对的写法是没问题的，但表单编码（application/x-www-form-urlencoded）本身是扁平的键值对格式，不支持直接传递嵌套结构。要实现嵌套参数的传递，通常有两种可行方案，具体取决于目标API的要求：

方案一：发送JSON格式的请求体（推荐，适配绝大多数现代API） #

像Xbox Live的认证这类接口，通常接受JSON格式的请求体。你可以将嵌套结构序列化为JSON字符串，再通过StringContent发送：

实现步骤： #

1. 定义匹配嵌套结构的类（或直接使用匿名类型）
2. 使用JSON序列化库（比如System.Text.Json或Newtonsoft.Json）将对象转为JSON字符串
3. 用StringContent封装JSON，并设置正确的Content-Type请求头

代码示例（使用System.Text.Json，.NET Core/.NET 5+内置）： #

using System.Text;
using System.Text.Json;

HttpClient client = new HttpClient();
string url = "https://user.auth.xboxlive.com/user/authenticate";

// 定义嵌套结构的匿名类型（也可以提前定义实体类）
var requestBody = new
{
    param1 = "value1",
    param2 = new
    {
        param2a = "values2a",
        param2b = "values2b",
        param2c = "values2c"
    },
    param3 = "value3"
};

// 序列化为JSON字符串
string json = JsonSerializer.Serialize(requestBody);

// 封装为StringContent，设置Content-Type为application/json
StringContent content = new StringContent(json, Encoding.UTF8, "application/json");

// 发送POST请求
HttpResponseMessage response = await client.PostAsync(url, content);

如果使用Newtonsoft.Json（Json.NET），只需替换序列化部分：

string json = Newtonsoft.Json.JsonConvert.SerializeObject(requestBody);

方案二：拆分为扁平的表单键值对（仅适配支持这种格式的后端） #

部分后端框架（如PHP、Spring Boot）支持通过param2[param2a]这种命名格式解析嵌套的表单参数。你可以将嵌套结构拆为扁平键值对：

代码示例： #

HttpClient client = new HttpClient();
string url = "https://user.auth.xboxlive.com/user/authenticate";

var values = new Dictionary<string, string>
{
    { "param1", "value1" },
    { "param2[param2a]", "values2a" },
    { "param2[param2b]", "values2b" },
    { "param2[param2c]", "values2c" },
    { "param3", "value3" }
};

FormUrlEncodedContent content = new FormUrlEncodedContent(values);
HttpResponseMessage response = await client.PostAsync(url, content);

注意：这种方式需要后端明确支持该格式，否则无法正确解析嵌套结构。对于Xbox Live的认证接口，更推荐使用方案一的JSON格式。

内容的提问来源于stack exchange，提问作者user2191367