Ocelot 23.2版本中ocelot.global.json合并问题的技术分析

问题背景

在Ocelot网关项目中，配置文件的管理是一个核心功能。开发者通常会将路由配置分散在多个JSON文件中，并通过ocelot.global.json文件来定义全局配置。然而，在升级到23.2版本后，许多开发者发现全局配置文件的内容不再被正确合并到最终配置中。

问题现象

当使用Configuration.AddOcelot方法加载位于子文件夹中的Ocelot配置文件时，ocelot.global.json中定义的全局配置（如RequestIdKey和ServiceDiscoveryProvider）会被忽略，系统会使用默认值而非配置文件中的值。

根本原因分析

经过深入代码审查，发现问题出在文件路径处理逻辑上。在GetMergedOcelotJson方法中，当检查全局配置文件时，代码直接使用文件名创建FileInfo对象，而没有考虑文件所在的子文件夹路径。这导致路径比较时出现不一致：

1. 通过DirectoryInfo.EnumerateFiles()获取的文件路径包含完整子文件夹路径
2. 而新建的FileInfo对象只包含文件名，没有子文件夹路径

这种不一致使得条件判断if (file.FullName == globalConfigFile.FullName)总是返回false，导致全局配置无法被正确加载。

解决方案

针对这个问题，社区提出了两种解决方案：

1. 显式指定全局配置文件路径：在使用AddOcelot方法时，明确包含子文件夹路径

builder.Configuration.AddOcelot("GatewayConfiguration", 
    builder.Environment, 
    MergeOcelotJson.ToMemory, 
    globalConfigFile: "GatewayConfiguration/ocelot.global.json");

2. 修改核心代码：修正文件路径处理逻辑，确保在创建FileInfo对象时包含完整的子文件夹路径

最佳实践建议

1. 配置访问方式：避免直接使用IInternalConfigurationRepository获取配置，推荐使用IOptions<FileConfiguration>进行依赖注入

2. 文件组织：将所有Ocelot配置文件（包括全局配置）放在同一文件夹中

3. 版本选择：如果急需此功能，可暂时回退到23.1.0版本，等待23.3版本修复

4. 测试验证：升级后务必验证全局配置是否生效，特别是自定义的ServiceDiscoveryProvider等关键配置

技术影响

这个问题不仅影响全局配置文件，同样会影响环境特定配置文件和主配置文件的加载。因此，在修复时需要全面考虑所有配置文件类型的路径处理逻辑。

总结

配置文件合并是Ocelot的核心功能之一，正确处理文件路径是确保配置正确加载的关键。开发者在使用子文件夹组织配置文件时需要特别注意这个问题，合理选择解决方案以确保系统稳定运行。