背景与痛点分析

在 .NET 生态中，尽管 .NET Core 及后续版本通过依赖项解析机制大幅缓解了"DLL Hell"问题，但在传统的 .NET Framework 和 ASP.NET Web 项目中，程序集版本冲突依然是一个常见的工程难题。通常，开发者需要在 web.config 或 App.config 中配置 <bindingRedirect> 节点，将旧版本的依赖请求重定向到实际部署的新版本。

然而，手动维护这些重定向配置不仅繁琐，而且在多环境构建时极易引发问题。例如，在本地 Visual Studio 环境中调试与在 GitLab CI 服务器上进行自动化发布时，由于 NuGet 缓存、构建工具链或环境变量的差异，同一个 NuGet 包最终生成的 DLL 版本号可能截然不同。

环境差异导致的配置冲突

假设项目依赖了 System.Web.Http 等核心组件。在本地开发环境中，运行时可能要求将版本重定向至 5.2.7.0：

<runtime>
  <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
    <dependentAssembly>
      <assemblyIdentity name="System.Web.Http" publicKeyToken="31bf3856ad364e35" culture="neutral" />
      <bindingRedirect oldVersion="0.0.0.0-65535.65535.65535.65535" newVersion="5.2.7.0" />
    </dependentAssembly>
    <dependentAssembly>
      <assemblyIdentity name="System.Net.Http.Formatting" publicKeyToken="31bf3856ad364e35" culture="neutral" />
      <bindingRedirect oldVersion="0.0.0.0-65535.65535.65535.65535" newVersion="5.2.7.0" />
    </dependentAssembly>
  </assemblyBinding>
</runtime>

但是，当代码推送到 GitLab CI 进行编译和发布后，实际输出的程序集版本可能变为了 5.3.0.0。如果此时不修改配置文件，应用在服务器上启动时就会抛出 FileLoadException。CI 环境需要的正确配置如下：

<runtime>
  <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
    <dependentAssembly>
      <assemblyIdentity name="System.Web.Http" publicKeyToken="31bf3856ad364e35" culture="neutral" />
      <bindingRedirect oldVersion="0.0.0.0-65535.65535.65535.65535" newVersion="5.3.0.0" />
    </dependentAssembly>
    <dependentAssembly>
      <assemblyIdentity name="System.Net.Http.Formatting" publicKeyToken="31bf3856ad364e35" culture="neutral" />
      <bindingRedirect oldVersion="0.0.0.0-65535.65535.65535.65535" newVersion="6.0.0.0" />
    </dependentAssembly>
  </assemblyBinding>
</runtime>

为了消除这种因环境差异导致的人工干预，开发一款能够自动扫描实际 DLL 版本并同步修正配置文件的命令行工具显得尤为必要。

自动化工具的应用场景

1. 本地命令行执行

在本地终端中，可以通过传递 --project 参数来精确指定目标项目路径。工具会自动解析项目输出目录中的 DLL，比对 web.config 中的声明，并自动清理冗余或重复的 <dependentAssembly> 节点。

2. IDE 集成终端

在 Visual Studio 的 Package Manager Console 或内置终端中，无需指定路径直接运行该工具。程序会自动向上级目录递归查找 web.config 或 App.config 文件，并完成版本对齐。

3. GitLab CI/CD 流水线集成

在自动化构建流水线中集成该工具时，需要注意标准输出（stdout）的捕获问题。如果直接在 .gitlab-ci.yml 中调用编译好的 C# 可执行文件，GitLab Runner 可能无法正确渲染控制台输出。推荐的做法是通过 PowerShell 脚本进行包装调用：

deploy_job:
  script:
    - pwsh -Command "& .\BindingRedirectFixer.exe --config .\web.config --bin .\bin | Write-Host"

核心实现逻辑

该工具的核心在于解析 XML 配置文件，并通过反射或程序集元数据读取实际 DLL 的版本号。以下是使用 C# 和 LINQ to XML 实现的核心同步逻辑：

using System;
using System.IO;
using System.Linq;
using System.Reflection;
using System.Xml.Linq;

namespace AssemblyBindingTools
{
    public class RedirectSynchronizer
    {
        private static readonly XNamespace AssemblySchema = "urn:schemas-microsoft-com:asm.v1";

        public void SyncConfiguration(string configPath, string binaryFolder)
        {
            if (!File.Exists(configPath))
                throw new FileNotFoundException("Config file not found.", configPath);

            var xmlDoc = XDocument.Load(configPath);
            var bindingNode = xmlDoc.Descendants(AssemblySchema + "assemblyBinding").FirstOrDefault();
            
            if (bindingNode == null) return;

            var dependentAssemblies = bindingNode.Elements(AssemblySchema + "dependentAssembly").ToList();

            foreach (var assemblyNode in dependentAssemblies)
            {
                var identity = assemblyNode.Element(AssemblySchema + "assemblyIdentity");
                var redirect = assemblyNode.Element(AssemblySchema + "bindingRedirect");

                if (identity == null || redirect == null) continue;

                string asmName = identity.Attribute("name")?.Value;
                if (string.IsNullOrWhiteSpace(asmName)) continue;

                string dllFullPath = Path.Combine(binaryFolder, $"{asmName}.dll");
                
                if (File.Exists(dllFullPath))
                {
                    Version diskVersion = AssemblyName.GetAssemblyName(dllFullPath).Version;
                    string configuredVersion = redirect.Attribute("newVersion")?.Value;

                    if (configuredVersion != diskVersion.ToString())
                    {
                        redirect.SetAttributeValue("newVersion", diskVersion.ToString());
                        Console.WriteLine($"[Sync] Updated {asmName} redirect to {diskVersion}");
                    }
                }
            }

            xmlDoc.Save(configPath);
        }
    }
}

上述代码通过 XDocument 加载配置文件，利用 LINQ 快速定位带有特定 XML 命名空间的节点。通过 AssemblyName.GetAssemblyName 方法，工具能够在不加载程序集到当前 AppDomain 的情况下，安全、高效地读取物理文件的版本号，从而确保配置修改的准确性与运行时的稳定性。