Harmony项目中的System.Text.Json类型加载问题解析

问题现象

在使用Harmony 2.3.3版本时，部分开发者遇到了一个运行时错误："Could not load type 'CORINFO_METHOD_INFO' from assembly 'System.Text.Json, Version=8.0.0.0..."。这个错误通常发生在调试环境中，而直接运行时却能正常工作。

根本原因

这个问题的本质是依赖冲突。Harmony的完整版(非Thin版本)内部打包了多个依赖项，包括System.Text.Json等库。当这些依赖项与宿主应用程序中的版本不一致时，就会出现类型加载失败的情况。

解决方案

方案一：使用Harmony Thin版本

Harmony提供了Thin版本，它不包含任何依赖项，将依赖管理完全交给开发者。这种方式可以避免版本冲突问题，因为开发者可以确保应用程序中只存在一个版本的System.Text.Json。

方案二：调整IL合并顺序

对于使用ILRepack等工具合并DLL的情况，DLL的合并顺序会影响类型解析。正确的做法是将Harmony的DLL放在合并列表的最前面：

ilrepack .... /out:packeddll.dll 0Harmony.dll mycustomdll.dll

而不是：

ilrepack .... /out:packeddll.dll mycustomdll.dll 0Harmony.dll

技术背景

.NET运行时在加载类型时遵循严格的版本匹配规则。当两个不同版本的同一程序集被加载时，即使类型名称相同，运行时也会将它们视为完全不同的类型。Harmony完整版内部打包的依赖可能与宿主应用程序的依赖产生冲突，导致类型转换失败。

最佳实践建议

1. 对于新项目，优先考虑使用Harmony Thin版本，自行管理依赖关系
2. 如果必须使用完整版，确保项目中的所有System.Text.Json引用版本一致
3. 使用NuGet的依赖解析功能来统一版本
4. 在合并DLL时，注意依赖顺序，基础库应放在前面

总结

依赖管理是.NET开发中的常见挑战。Harmony通过提供Thin版本给了开发者更多灵活性。理解.NET的类型加载机制和依赖解析规则，可以帮助开发者更好地解决这类运行时错误。在遇到类似问题时，检查依赖版本一致性应该是首要的排查步骤。