SpecFlow .NET 3.1项目测试抛出Invalid URI主机名无法解析异常

根因说明 #

该异常触发于配置系统初始化阶段：ClientConfigPaths类构造时会将测试执行程序的本地路径转换为URI格式，当路径中包含URI保留字符、格式错误的UNC网络路径、中文/特殊符号时，URI解析逻辑会误将路径片段识别为主机名导致解析失败，最终引发配置系统初始化失败，测试执行器无法正常加载测试用例，所以表现为所有测试被跳过。

定位步骤 #

• 打印测试执行上下文的实际路径：在测试项目的全局初始化方法中加入以下代码，输出运行时的路径信息：

Console.WriteLine("程序集运行路径：{0}", System.Reflection.Assembly.GetExecutingAssembly().Location);
Console.WriteLine("基础目录：{0}", AppContext.BaseDirectory);

检查输出的路径是否包含#、%、&、@等特殊字符、中文，或者是格式不规范的网络共享路径（例如缺少前缀的UNC路径）。

• 检查测试项目的输出目录配置：打开测试项目属性的「生成」页，确认输出路径配置无特殊字符、无路径截断问题。
• 检查测试运行器配置：如果使用OutOfProcess模式执行测试，确认运行器传入的测试程序集路径无转义错误。

解决方案 #

• 优先修复路径问题：将整个解决方案迁移到纯英文、无特殊符号的本地目录下，例如D:\Projects\SpecFlowDemo\，避免路径中出现任何会触发URI解析异常的字符，重新生成解决方案后再执行测试。
• 网络路径适配：如果代码存放在网络共享目录中，将共享目录映射为本地磁盘盘符后再打开项目，不要直接使用UNC路径（格式为\\服务器地址\共享名\路径）访问项目。
• 手动指定配置文件规避：如果不方便修改路径，可在测试项目中加入全局初始化逻辑，提前指定配置文件路径，绕开默认的路径解析逻辑，代码示例如下：

using System.Configuration;
using System.IO;
using Microsoft.VisualStudio.TestTools.UnitTesting;

[TestClass]
public static class TestAssemblyInit
{
    [AssemblyInitialize]
    public static void Init(TestContext context)
    {
        // 手动指定配置文件路径
        string configPath = Path.Combine(AppContext.BaseDirectory, "testhost.dll.config");
        AppDomain.CurrentDomain.SetData("APP_CONFIG_FILE", configPath);
        // 提前触发配置系统初始化
        var dummy = ConfigurationManager.AppSettings;
    }
}

• 依赖包版本升级：将NuGet包System.Configuration.ConfigurationManager升级到6.0+的兼容版本，修复旧版本中存在的路径解析已知BUG。

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