C#(.NET Core)未知根属性名时用System.Text.Json提取JSON节点值

现有实现的可优化点 #

你当前的实现逻辑方向正确，但存在几处可以改进的地方：

• 存在重复属性查找：先取根属性名、再两次调用GetProperty获取节点，有冗余的属性遍历开销
• 缺少边界校验：遇到根节点为空、根属性不是对象、不存在eventType字段等异常输入时，会直接抛出未处理的运行时错误
• 取payload文本的方法性能一般：ToString()会重新序列化节点内容，开销远高于直接读取原始文本的内置API
• 默认大小写严格匹配：如果业务场景中存在EventType/eventtype这类大小写不一致的字段名，会直接匹配失败

优化后实现代码 #

全程使用内置System.Text.JsonAPI，无任何第三方依赖：

// 若业务要求属性名严格大小写匹配，可移除该配置
var parseOptions = new JsonDocumentOptions
{
    PropertyNameCaseInsensitive = true
};

using JsonDocument doc = JsonDocument.Parse(jsonContent, parseOptions);
JsonElement root = doc.RootElement;

// 基础格式校验
if (root.ValueKind != JsonValueKind.Object)
{
    throw new InvalidDataException("非法JSON格式：根节点必须为对象类型");
}
// 直接取根节点第一个属性，符合题目"根节点仅含1个未知属性"的约束
JsonProperty rootProperty = root.EnumerateObject().First();
JsonElement payloadNode = rootProperty.Value;

if (payloadNode.ValueKind != JsonValueKind.Object)
{
    throw new InvalidDataException("非法JSON格式：根属性对应值必须为对象类型");
}
if (!payloadNode.TryGetProperty("eventType", out JsonElement eventTypeElement))
{
    throw new InvalidDataException("非法JSON格式：payload中缺少必填的eventType字段");
}

string eventType = eventTypeElement.GetString();
// GetRawText()直接返回节点对应的原始JSON片段，无需重新序列化，性能远优于ToString()
string payload = payloadNode.GetRawText();

return (eventType, payload);

核心优化说明 #

• 直接获取根节点下的第一个JsonProperty对象，无需先取属性名再二次查找，减少一次属性遍历开销
• 使用GetRawText()替代ToString()获取payload内容：该方法直接返回输入JSON中对应节点的原始文本，不需要做序列化拼接，性能提升明显，且能完整保留原始JSON的结构
• 增加多层格式校验，对非法输入抛出明确的错误信息，避免出现无明确堆栈的空引用、类型不匹配异常
• 可选开启大小写不敏感匹配，适配更多业务场景
• 所有操作均为直接读取已解析的节点，没有额外的内存拷贝开销

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