C#：基于Newtonsoft.JSON检测JSON结构是否变更

这个需求太常见了——很多依赖第三方JSON接口的开发者都会遇到结构变更的坑。用Newtonsoft.JSON的话，我有两种实用方案，既能满足你只关注结构、忽略值和数组数量的要求，又不用手动天天检查：

Newtonsoft专门提供了Newtonsoft.Json.Schema库来处理JSON结构校验，刚好能精准匹配你的需求——只关心结构和数据类型，完全忽略具体值、字符串长度、数组元素数量这些细节。

步骤1：安装依赖包 #

首先得装对应的NuGet包：

Install-Package Newtonsoft.Json.Schema

步骤2：生成基准结构Schema #

从你确认结构正确的JSON文件生成一个「结构模板」，并且配置生成规则，让它只保留必要的结构信息：

using Newtonsoft.Json;
using Newtonsoft.Json.Schema;
using Newtonsoft.Json.Schema.Generation;

// 加载你确认正确的基准JSON
string baselineJson = File.ReadAllText("baseline.json");
JToken baselineToken = JToken.Parse(baselineJson);

// 配置Schema生成器：只保留结构和类型，忽略值约束和数组数量
var schemaSettings = new JsonSchemaGeneratorSettings
{
    // 不生成值相关的约束（比如字符串格式、数值范围）
    DefaultRequired = Required.Default,
    // 忽略数组的元素数量限制（不管数组长还是短，只要是数组就符合）
    GenerateArraySchemas = false,
    // 如果要求严格匹配（不允许新增未知字段），可以打开下面两行注释
    // SchemaIdGenerationHandling = SchemaIdGenerationHandling.None,
    // Properties = new JsonSchemaGeneratorProperties { Required = Required.Always }
};

var generator = new JsonSchemaGenerator(schemaSettings);
JsonSchema baselineSchema = generator.Generate(baselineToken.Type);

步骤3：验证新获取的JSON #

每次拿到新的JSON后，用基准Schema验证即可，不通过就说明结构变了：

// 加载新获取的JSON
string newJson = File.ReadAllText("new.json");
JToken newToken = JToken.Parse(newJson);

// 验证结构
bool isStructureValid = newToken.IsValid(baselineSchema, out IList<string> errors);

if (!isStructureValid)
{
    Console.WriteLine("⚠️ JSON结构发生变更！错误详情：");
    foreach (var error in errors)
    {
        Console.WriteLine($"  - {error}");
    }
}
else
{
    Console.WriteLine("✅ JSON结构符合预期");
}

如果你不想依赖额外的Schema包，或者需要更个性化的校验规则（比如某些字段允许类型兼容），可以自己写递归遍历的方法，手动对比两个JSON的结构骨架：

核心逻辑很简单：

• 先对比节点类型（是对象、数组还是基本类型）
• 对象类型：检查基准里的所有字段是否都存在，递归对比子字段结构
• 数组类型：只需要确认是数组，不管里面有多少元素
• 基本类型：只看类型是否一致，忽略具体值

代码实现：

using Newtonsoft.Json.Linq;

public static bool IsJsonStructureMatching(JToken baseline, JToken current)
{
    // 第一步：对比节点类型
    if (baseline.Type != current.Type)
        return false;

    switch (baseline.Type)
    {
        case JTokenType.Object:
            var baselineObj = (JObject)baseline;
            var currentObj = (JObject)current;

            // 检查基准中的所有字段是否都在新JSON中存在
            foreach (var prop in baselineObj.Properties())
            {
                if (!currentObj.ContainsKey(prop.Name))
                    return false;

                // 递归对比子字段的结构
                if (!IsJsonStructureMatching(prop.Value, currentObj[prop.Name]))
                    return false;
            }

            // 如果需要严格匹配（不允许新增字段），取消下面的注释
            // foreach (var prop in currentObj.Properties())
            // {
            //     if (!baselineObj.ContainsKey(prop.Name))
            //         return false;
            // }

            return true;

        case JTokenType.Array:
            // 只要是数组类型就符合，不管元素数量和内容
            return true;

        // 基本类型（字符串、数字、布尔、null）只看类型
        case JTokenType.Integer:
        case JTokenType.Float:
        case JTokenType.String:
        case JTokenType.Boolean:
        case JTokenType.Null:
            return true;

        default:
            // 其他特殊类型（比如构造器）按类型匹配
            return baseline.Type == current.Type;
    }
}

// 使用示例
string baselineJson = File.ReadAllText("baseline.json");
JToken baseline = JToken.Parse(baselineJson);

string newJson = File.ReadAllText("new.json");
JToken newToken = JToken.Parse(newJson);

bool isMatch = IsJsonStructureMatching(baseline, newToken);
Console.WriteLine(isMatch ? "✅ 结构未变化" : "⚠️ 结构已变更");

• 可以把基准JSON或者Schema存成配置文件，每次程序启动时加载，不用硬编码
• 如果要实现每日自动检测，把这个逻辑做成控制台程序，配合系统的任务计划（Windows任务计划/ Linux Cron）定时执行就行
• 如果需要关心数组元素的结构（比如数组里的对象必须符合某个结构），那在方案一里开启GenerateArraySchemas=true，方案二里可以递归检查数组的第一个元素结构（假设数组元素结构一致）

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