VS2019 .NET Core Azure HttpTrigger函数Newtonsoft.Json反序列化空引用问题
空引用异常触发原因与序列化库逻辑差异说明
本次异常的核心触发根源
- 异常并非源于Newtonsoft.Json不会自动初始化嵌套对象,本质是类属性与JSON字段的名称映射不匹配:
你在WebhookTest类中定义的嵌套属性为YourName,但请求体JSON中对应字段为带下划线的蛇形命名your_name。Newtonsoft.Json的默认映射规则下,不会自动对这类带格式差异的名称做智能匹配,识别不到对应字段时,YourName属性会保持实例默认值null,后续访问wht.YourName.last自然触发空引用错误。
对比你之前在System.Text.Json项目中的顺畅体验,本质是项目全局配置了蛇形命名策略,自动完成了your_name和YourName的映射,并非System.Text.Json的嵌套初始化逻辑有特殊设计。
两个序列化库的嵌套反序列化逻辑差异
- 核心嵌套初始化逻辑无本质差异:只要库能正确识别到JSON中的嵌套字段、匹配上对应类的嵌套属性,两个库都会自动实例化嵌套类对象,无需手动对
NameBlock类做预初始化赋值。不存在“System.Text.Json会自动补全嵌套属性初始化、Newtonsoft.Json不会”的实现区别。 - 实际体验差异来自默认名称匹配规则:
- System.Text.Json支持灵活的全局命名策略配置,很多.NET项目模板(包括Azure Function默认的输入绑定配置)会自动启用驼峰/蛇形命名映射,无需为每个属性单独标注映射特性即可完成匹配
- Newtonsoft.Json默认匹配规则为:仅对大小写不同的同拼写名称做不敏感匹配,不会自动识别带下划线、分隔符等格式差异的名称,比如
YourName和your_name因字符组成不同,就算忽略大小写也无法自动匹配,必须显式指定映射关系
可直接落地的修复方案
任选其一即可:
- 为
YourName属性补充显式映射特性:[JsonProperty("your_name")] public NameBlock YourName { get; set; } - 给Newtonsoft.Json配置全局蛇形命名解析规则,批量完成同格式的属性映射:
var jsonSettings = new JsonSerializerSettings { ContractResolver = new DefaultContractResolver { NamingStrategy = new SnakeCaseNamingStrategy() } }; WebhookTest wht = JsonConvert.DeserializeObject<WebhookTest>(requestBody, jsonSettings);
注意:你当前类中给
UploadafileOptional标注的特性值"Uploadafile(optional)"和请求体里的实际字段upload_a_file_optional并不匹配,即使修复了YourName的映射问题,该属性也会保持null,后续访问时会触发同类空引用错误,需要同步修正映射关系。
内容的提问来源于stack exchange,提问作者GCDevOps
相关产品推荐
相关产品推荐

