VS 2022自定义测试适配器创建失败求助及调试咨询

一、先确认适配器是否被加载 #

1. 用vstest.console.exe验证 #

运行以下命令，查看已加载的测试发现器列表：

vstest.console.exe /listdiscoverers

如果你的CustomTestDiscoverer不在列表中，说明适配器未被正确识别，需检查部署方式或配置。

2. 查看VS活动日志 #

打开VS的工具->选项->项目和解决方案->生成并运行，将“MSBuild项目构建输出详细程度”设为详细，重新触发测试发现。或者直接查看日志文件：

%APPDATA%\Microsoft\VisualStudio\17.0_<你的实例ID>\ActivityLog.xml

搜索适配器类名，确认是否有加载失败的报错信息。

3. 生成vstest诊断日志 #

运行测试发现命令并生成诊断日志，查看适配器加载细节：

vstest.console.exe <你的测试DLL路径> /diag:test_diag.log

在test_diag.log中搜索适配器类名，排查是否有加载异常或逻辑错误。

二、VSIX/NuGet适配器调试方法 #

调试VSIX适配器 #

1. 打开VSIX项目，右键项目属性->调试，设置“启动外部程序”为VS2022的devenv.exe路径：

   C:\Program Files\Microsoft Visual Studio\2022\Community\Common7\IDE\devenv.exe
   

2. 添加命令行参数：/rootsuffix Exp，启动VS实验实例。
3. 在CustomTestDiscoverer.DiscoverTests方法打断点，在实验实例中打开测试项目，触发测试发现，看是否命中断点。
4. 检查VSIX清单文件，确保已添加测试适配器扩展点：

   <Extensions>
     <Extension Category="Microsoft.VisualStudio.TestTools.TestDiscoverer" Type="YourNamespace.CustomTestDiscoverer" />
     <Extension Category="Microsoft.VisualStudio.TestTools.TestExecutor" Type="YourNamespace.CustomTestExecutor" />
   </Extensions>
   

调试NuGet包适配器 #

1. 将适配器NuGet包安装到测试项目后，打开测试项目属性->调试，勾选“启用本机代码调试”。
2. 运行命令触发测试发现：

   vstest.console.exe <你的测试DLL路径> /discover
   

3. 在VS中通过调试->附加到进程，找到并附加到vstest.console.exe进程。
4. 在适配器代码的关键方法打断点，重新运行发现命令，验证是否进入调试逻辑。
5. 检查NuGet包结构：确保适配器DLL放在build/目录下，且包含对应的.targets文件：

   <Project>
     <ItemGroup>
       <VSTestAdapterFiles Include="$(MSBuildThisFileDirectory)..\lib\net6.0\YourAdapter.dll" />
       <Content Include="@(VSTestAdapterFiles)">
         <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
       </Content>
     </ItemGroup>
   </Project>
   

三、代码实现的潜在问题修复 #

1. ExecutorUri一致性检查 #

确保ExecutorUriString.ExecutorString是唯一且格式正确的URI（如"executor://CustomTestAdapter/v1"），且发现器和执行器的URI完全一致，不能有拼写错误。

2. 测试类判断逻辑修正 #

你的代码中通过基类名称判断测试类，如果实际是用[TestClass]属性标记测试类，需修改逻辑：

// 原错误逻辑：判断基类名称
var testClasses = assembly.GetTypes().Where(type => type.BaseType.Name.EndsWith(testClassAttr)).ToList();

// 修正为：判断自定义属性
var testClasses = assembly.GetTypes()
    .Where(type => type.CustomAttributes.Any(attr => attr.AttributeType.Name.EndsWith(testClassAttr)))
    .ToList();

3. Assembly加载异常处理 #

添加异常捕获并输出日志，排查DLL加载失败问题：

public static IEnumerable<TestCase> GetTests(string source)
{
    var tests = new List<TestCase>();
    try
    {
        // 推荐用ReflectionOnlyLoadFrom避免加载依赖问题
        var assembly = Assembly.ReflectionOnlyLoadFrom(source);
        // 后续逻辑...
    }
    catch (Exception ex)
    {
        // 这里可以通过logger输出错误，或者暂时用Debug.WriteLine调试
        System.Diagnostics.Debug.WriteLine($"Load assembly failed: {ex.Message}");
    }
    return tests;
}

4. TestCase完善信息 #

创建TestCase时补充显示名称和代码位置，提升VS测试资源管理器的显示效果：

tests.Add(new TestCase(method.Name, ExecutorUriString.ExecutorUri, source)
{
    DisplayName = $"{method.DeclaringType.Name}.{method.Name}",
    CodeFilePath = method.DeclaringType.Assembly.Location,
    LineNumber = 0 // 如果能获取到行号可以补充
});

5. 空值安全处理 #

在RunTests方法中添加空值判断，避免空引用异常：

public void RunTests(IEnumerable<TestCase>? tests, IRunContext? runContext, IFrameworkHandle? frameworkHandle)
{
    if (tests == null || frameworkHandle == null) return;
    // 后续逻辑...
}

四、VS2022适配注意事项 #

• 适配器项目目标框架需设为.NET 6.0或更高（VS2022默认支持版本）。
• 引用的Microsoft.VisualStudio.TestPlatform.ObjectModel包版本需与VS2022内置版本匹配（推荐用17.0.0+）。
• 测试项目的目标框架需与适配器兼容，避免跨框架加载问题。

五、极简验证示例 #

先实现一个极简发现器，验证适配器能否被正常加载：

[FileExtension(".dll")]
[DefaultExecutorUri("executor://MinimalTestAdapter/v1")]
public class MinimalTestDiscoverer : ITestDiscoverer
{
    public void DiscoverTests(IEnumerable<string> sources, IDiscoveryContext discoveryContext, IMessageLogger logger, ITestCaseDiscoverySink discoverySink)
    {
        logger.SendMessage(TestMessageLevel.Informational, "Minimal discoverer loaded successfully!");
        foreach (var source in sources)
        {
            discoverySink.SendTestCase(new TestCase("HardcodedTest", new Uri("executor://MinimalTestAdapter/v1"), source)
            {
                DisplayName = "Hardcoded Test Case"
            });
        }
    }
}

如果这个极简版本能在测试资源管理器显示测试，再逐步添加原有业务逻辑，定位问题点。

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