C#使用JsonConvert反序列化时字符串型数值转long且空值默认0的实现方案
适配Newtonsoft.Json的通用字符串转long、空值兜底方案
上述问题完全可以通过自定义Newtonsoft.Json类型转换器的通用方案解决,不需要修改接口返回结构,也不需要逐字段重复编写转换逻辑,一次实现即可覆盖项目内所有同类字段的映射需求。
原实现报错的根因
此前在属性get访问器中编写转换逻辑会触发栈溢出崩溃,核心是逻辑递归调用自身:在id属性的get块中访问this.id会再次触发当前get方法的执行,形成无限循环,最终耗尽栈内存。这个思路本身没有触达反序列化阶段的类型匹配问题,完全无法实现预期效果。
通用转换器实现
自定义支持多场景输入的long类型转换器,覆盖所有可能的JSON输入情况,直接复用给所有同类字段:
using Newtonsoft.Json; using System; /// <summary> /// 支持字符串格式数字转long、空值/异常值默认赋值为0的通用转换器 /// </summary> public class LongWithEmptyStringDefaultConverter : JsonConverter { public override bool CanWrite => false; public override bool CanConvert(Type objectType) { // 精准匹配非可空long类型,和实体定义的类型完全对齐 return objectType == typeof(long); } public override object ReadJson(JsonReader reader, Type objectType, object existingValue, JsonSerializer serializer) { // 处理null值场景,直接返回0 if (reader.TokenType == JsonToken.Null) return 0L; // 处理字符串类型输入 if (reader.TokenType == JsonToken.String) { var stringValue = reader.Value?.ToString().Trim() ?? string.Empty; // 空字符串直接返回0 if (string.IsNullOrWhiteSpace(stringValue)) return 0L; // 解析有效数字字符串为long,解析失败兜底返回0 if (long.TryParse(stringValue, out var parsedValue)) return parsedValue; return 0L; } // 处理JSON原生数字类型输入,直接转换为long if (reader.TokenType == JsonToken.Integer) return Convert.ToInt64(reader.Value); // 其他异常输入统一兜底返回0 return 0L; } public override void WriteJson(JsonWriter writer, object value, JsonSerializer serializer) { // 只读场景下不需要实现序列化逻辑,此处不会被触发 throw new NotImplementedException(); } }
两种接入方式
根据项目的实际适配范围,可以选择全局注册或者局部标注,两种方式都不需要修改原有实体的属性类型。
- 全局注册(适合项目内所有long字段都需要适配的场景)
在程序启动初始化阶段配置Newtonsoft.Json的全局默认设置,所有后续反序列化操作会自动应用转换逻辑,完全不用修改任何实体代码:JsonConvert.DefaultSettings = () => new JsonSerializerSettings { Converters = new List<JsonConverter> { new LongWithEmptyStringDefaultConverter() } }; - 局部属性标注(适合仅部分字段需要适配的场景)
不需要全局配置,给需要做特殊转换的属性单独加特性即可:public class Error { [JsonConverter(typeof(LongWithEmptyStringDefaultConverter))] public long id { get; set; } public string code { get; set; } public string message { get; set; } [JsonConverter(typeof(LongWithEmptyStringDefaultConverter))] public long qty{ get; set; } }
效果验证
使用给定的测试JSON报文执行反序列化流程时:
- 被双引号包裹的字符串数字
"15006"会被自动转换为真实的long类型值15006 - 空字符串值
""会被自动赋值为long类型的0 - 最终生成的实体中所有数值字段都是原生长整型,后续导出Excel时会被识别为数值格式,不会出现被当作文本处理的问题
内容的提问来源于stack exchange,提问作者causita
相关产品推荐
相关产品推荐

