Minimal API返回Tuple异常：空JSON问题如何解决？

问题原因 #

Minimal API默认使用的System.Text.Json序列化器不会自动序列化值Tuple的字段，所以你返回的命名Tuple会被序列化为空JSON{}，反序列化自然得到默认值(0,0,0,0)。

解决方案 #

1. 用类/结构体封装原始类型（推荐） #

这是最直观且易维护的方式，序列化器能正常识别类的属性：

// 定义结果类型
public class ColorkeyRectResult
{
    public int X { get; set; }
    public int Y { get; set; }
    public int W { get; set; }
    public int H { get; set; }
}

// 修改方法返回类型
public ColorkeyRectResult ColorkeyRect()
{
    return new ColorkeyRectResult { X = 10, Y = 10, W = 10, H = 10 };
}

// API映射保持不变
app.MapPost("/colorkeyrect", () => server.ColorkeyRect());

此时返回的JSON为{"X":10,"Y":10,"W":10,"H":10}，客户端可以正常反序列化。

2. 返回匿名类型 #

如果不想额外定义类，可以直接返回匿名类型，序列化器会正确生成带键的JSON：

app.MapPost("/colorkeyrect", () => new { x = 10, y = 10, w = 10, h = 10 });

返回的JSON为{"x":10,"y":10,"w":10,"h":10}，客户端可反序列化为对应Tuple或类。

3. 配置序列化器支持Tuple字段 #

若坚持使用Tuple，可修改System.Text.Json的配置，使其序列化Tuple的字段：

var builder = WebApplication.CreateBuilder(args);
// 配置序列化选项
builder.Services.ConfigureHttpJsonOptions(options =>
{
    options.SerializerOptions.IncludeFields = true;
});

var app = builder.Build();
// API映射不变
app.MapPost("/colorkeyrect", () => server.ColorkeyRect());

注意：这种方式下，命名Tuple的自定义名称会被忽略，返回的JSON键为Item1/Item2/Item3/Item4，即{"Item1":10,"Item2":10,"Item3":10,"Item4":10}，客户端反序列化时需对应位置的Tuple类型。

总结 #

Minimal API支持返回Tuple，但默认序列化行为无法识别命名Tuple的自定义字段名。推荐优先使用类/结构体或匿名类型返回，以保证JSON结构符合预期。

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