.NET Core自定义JSON响应：无需新增模型优化元组序列化输出

方案1：匿名类嵌套映射（最推荐，无额外类） #

直接在返回时用匿名类包裹外层ordersAndPayments，同时将每个具名元组转换为包含指定字段名的匿名类，一步解决两层问题：

[HttpGet]
public IActionResult GetOrdersAndPayments()
{
    IEnumerable<(Order order, Payment payment)> data = GetYourData();
    return Ok(new 
    { 
        ordersAndPayments = data.Select(t => new { t.order, t.payment }) 
    });
}

序列化后的JSON会自动生成ordersAndPayments外层键，内部每个元素的字段名就是order和payment，完全不需要新增任何实体类。

方案2：配置System.Text.Json支持具名元组序列化（.NET 5+适用） #

如果你的项目基于.NET 5及以上版本，System.Text.Json默认支持具名元组的字段名序列化，若当前配置覆盖了默认行为（比如自定义命名策略），可显式调整配置确保元组字段名被保留：

// .NET 6+ 在Program.cs中配置
builder.Services.AddControllers()
    .AddJsonOptions(options =>
    {
        // 禁用会修改元组字段名的自定义命名策略，或使用兼容的驼峰策略
        options.JsonSerializerOptions.PropertyNamingPolicy = null;
        // 如需驼峰命名可改用：options.JsonSerializerOptions.PropertyNamingPolicy = JsonNamingPolicy.CamelCase;
    });

配置完成后，直接用匿名类包裹外层即可：

return Ok(new { ordersAndPayments = data });

此时元组的order和payment会被正确序列化，而非item1/item2。

方案3：针对Newtonsoft.Json的配置（使用Json.NET时适用） #

若项目用的是Newtonsoft.Json，默认不会识别具名元组的字段名，可添加自定义契约解析器来修复：

public class TupleContractResolver : DefaultContractResolver
{
    protected override JsonProperty CreateProperty(MemberInfo member, MemberSerialization memberSerialization)
    {
        var property = base.CreateProperty(member, memberSerialization);
        if (member.DeclaringType.IsGenericType && member.DeclaringType.GetGenericTypeDefinition() == typeof(ValueTuple<,>))
        {
            var tupleNames = member.DeclaringType.GetCustomAttribute<TupleElementNamesAttribute>();
            if (tupleNames != null && tupleNames.TransformNames.Length > 0)
            {
                var index = int.Parse(member.Name.Substring(4)); // 从Item1/Item2提取索引
                property.PropertyName = tupleNames.TransformNames[index - 1];
            }
        }
        return property;
    }
}

然后在服务配置中启用该解析器：

builder.Services.AddControllers()
    .AddNewtonsoftJson(options =>
    {
        options.SerializerSettings.ContractResolver = new TupleContractResolver();
    });

之后用匿名类包裹外层即可满足需求。

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