ASP.NET Core 5中CreatedAtAction返回复杂对象时无响应数据问题

问题排查与解决方法 #

你遇到的复杂对象返回空JSON、但单独返回内部属性类型正常的问题，本质是JSON序列化器无法正确识别ComplexObject的可序列化成员导致的，按以下优先级排查即可解决：

1. 检查是否加了[Serializable]特性

这是匹配度最高的常见原因：
如果你的ComplexObject类标记了[Serializable]特性，.NET Core 3.0+默认使用的System.Text.Json序列化器会优先序列化类的字段而非属性，你用的自动生成属性没有显式声明公共字段，所以最终序列化结果为空。而User、Job类没有加该特性，所以单独返回时序列化正常。
修复方法二选一：

• 直接移除ComplexObject上的[Serializable]特性即可
• 如果必须保留该特性，在Program.cs（.NET 6+）或Startup.cs中修改全局JSON配置：

builder.Services.AddControllers()
    .AddJsonOptions(options =>
    {
        options.JsonSerializerOptions.IgnoreSerializableAttribute = true;
    });

如果你的项目用的是Newtonsoft.Json作为序列化器，无需额外配置，默认会优先序列化属性。

2. 检查可空引用类型配置

如果你的项目开启了可空引用类型开关，ComplexObject的User、Job属性未初始化也未标记为可空，部分版本的序列化器会触发可空校验规则，忽略未显式初始化的属性的序列化，修复方法：

public class ComplexObject {
  public User User {get; set;} = default!;
  public Job Job {get; set;} = default!;
}

3. 检查类的访问级别

确认ComplexObject、User、Job三个类都是public访问修饰符，非public的类默认无法被序列化器访问成员，会返回空对象。

4. 临时验证手段

你可以先修改返回值为匿名对象测试，如果匿名对象能正常返回，即可完全确认是ComplexObject的类定义与序列化配置不匹配的问题，和CreatedAtAction方法本身无关：

return CreatedAtAction(nameof(GetJob), new { id = jobId }, new {
    User = new User{ UserId = "hello" },
    Job = new Job{ Id = jobId }
});

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