.NET 7 API中C#元组序列化显示Item而非属性名的解决方法

方法1：转换为匿名类型列表 #

直接将具名元组集合转换为匿名类型集合，匿名类型的属性名会被JSON序列化器正确识别并输出：

// 假设你已获取到具名元组列表
List<(string JobId, string Message, bool HasError)> operationResults = GetBatchOperationResults();

// 转换为匿名类型列表后返回
return Ok(operationResults.Select(t => new { t.JobId, t.Message, t.HasError }).ToList());

这种方式简单直接，无需修改全局配置，仅针对当前接口的返回结果做转换。

方法2：全局配置System.Text.Json包含字段 #

具名元组的成员本质是公共字段，而System.Text.Json默认仅序列化公共属性。在.NET 7中，只需全局配置序列化器包含字段，就能让具名元组的自定义名称被正确序列化：

在Program.cs中添加如下配置：

builder.Services.AddControllers()
    .AddJsonOptions(options =>
    {
        // 开启字段序列化，让具名元组的自定义名称生效
        options.JsonSerializerOptions.IncludeFields = true;
    });

配置完成后，直接返回具名元组列表即可得到预期的JSON输出，无需额外转换。

方法3：使用字典列表（可选） #

如果需要更灵活的结构，可以将每个具名元组转换为Dictionary<string, object>，再返回字典列表：

var resultDictList = operationResults.Select(t => new Dictionary<string, object>
{
    { nameof(t.JobId), t.JobId },
    { nameof(t.Message), t.Message },
    { nameof(t.HasError), t.HasError }
}).ToList();

return Ok(resultDictList);

这种方式适合需要动态调整返回字段的场景，但可读性和简洁性不如前两种方法。

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