.NET 5环境Blazor中使用System.Text.Json序列化List<T>时元素为空对象
问题根因
该现象的核心原因与System.Text.Json的默认序列化规则直接相关:
- 库的默认行为为仅序列化类的公共属性,不会对公共字段执行序列化操作,这和旧版Newtonsoft.Json的默认行为存在明显差异(Newtonsoft.Json默认会序列化公共字段),很多从旧序列化组件迁移到System.Text.Json的项目容易踩中该坑。
- 你定义的
ReturnedQCResult类中所有成员均为无get/set访问器的公共字段,不属于公共属性范畴。即便调试时能看到字段已经填充了正确的赋值内容,序列化过程中这些字段也会被直接忽略,最终就会出现「List内元素长度正常、但每个元素输出为空对象{}」的表现,和你观察到的{"Answers":[{},{},{},{}]}序列化结果完全匹配。
可落地的解决方法
根据实际项目的改动成本,可以选择两种方案解决:
方案1:调整实体类定义(长期维护的最优方案)
将原本的公共字段修改为带get/set访问器的公共属性,修改后的实体定义参考:
public class ReturnedQCResult { public string Question { get; set; } public int QuestionEntryTypeID { get; set; } public char QuestionType { get; set; } public short QuestionSequence { get; set; } public string Text { get; set; } public decimal? Number { get; set; } public bool? YesNo { get; set; } public DateTime? DateEntry { get; set; } public TimeSpan? TimeEntry { get; set; } public long QuestionID { get; set; } }
修改为属性形式后,无需额外配置即可被默认规则正确序列化,也是C#中POCO类的常规编写方式,长期来看可减少各类序列化、ORM映射场景的兼容问题。
方案2:通过序列化配置兼容原有字段定义
如果老项目暂时无法改动原有实体类的字段写法,可以在序列化时通过配置开启公共字段的序列化支持,无需修改实体代码:
var serializeOptions = new JsonSerializerOptions { // 开启公共字段序列化能力,.NET 5 原生支持 // 注意该配置仅会序列化访问修饰符为public的字段,非公共字段仍不会被处理 IncludeFields = true, // 可选配置:对齐JSON常用的驼峰命名规则 PropertyNamingPolicy = JsonNamingPolicy.CamelCase }; // 序列化时传入自定义配置 string content = JsonSerializer.Serialize(obj, serializeOptions);
如果是Blazor项目中全局使用的序列化逻辑(比如和服务端交互的HttpClient序列化配置、MVC控制器的入参序列化配置),可以将IncludeFields = true的配置注册到全局服务中,实现全局生效,无需在每处序列化逻辑中重复传递配置:
// Program.cs 中注册全局Json配置 builder.Services.AddRazorPages() .AddJsonOptions(options => options.JsonSerializerOptions.IncludeFields = true);
内容的提问来源于stack exchange,提问作者Luke T O'Brien
相关产品推荐
相关产品推荐

