ASP.NET Core 3.1：WebApplicationFactoryContentRootAttribute设置无效解决方法

看起来你遇到的核心问题是WebApplicationFactoryContentRootAttribute没有被正确识别，导致内容根目录解析错误。咱们一步步来排查和解决：

1. 先补上关键的NuGet依赖包 #

WebApplicationFactory和WebApplicationFactoryContentRootAttribute都属于Microsoft.AspNetCore.Mvc.Testing包，但我看你的测试项目csproj里没有引用这个包！这是最可能的原因之一——没有依赖包的话，框架根本不会处理这个属性。

赶紧在测试项目的<ItemGroup>里添加：

<PackageReference Include="Microsoft.AspNetCore.Mvc.Testing" Version="3.1.0" />

版本要和你的ASP.NET Core 3.1对应，别用错版本。

2. 严格匹配Assembly FullName #

你在测试代码里已经输出了Startup所在程序集的FullName，一定要确保属性里的第一个参数和这个输出完全一致，包括版本、公钥令牌等细节，不能有任何拼写或格式错误。

比如如果你的输出是：

WebApp, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null

那属性里的第一个参数必须一模一样，多一个空格或者少个逗号都会导致匹配失败。

3. 调整相对路径的基准 #

WebApplicationFactoryContentRootAttribute里的路径是相对于测试项目的输出目录（比如bin/Debug/netcoreapp3.1），而不是解决方案根目录。

假设你的目录结构是：

你的解决方案根/
├─ Src/
│  └─ WebApp/
└─ Tests/
   └─ WebApp.FunctionalTests/
      └─ bin/
         └─ Debug/
            └─ netcoreapp3.1/

那从输出目录到Src/WebApp的相对路径应该是../../../../Src/WebApp（往上走4层回到解决方案根，再进入Src/WebApp），而不是你用的../../../Src/WebApp——少一层的话就会解析到解决方案根下的WebApp（不存在的目录）。

修正后的属性应该是：

[assembly: WebApplicationFactoryContentRootAttribute(
    "WebApp, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null",
    "../../../../Src/WebApp",
    "Program.cs",
    "1")]

4. 更可靠的替代方案：手动指定内容根 #

如果你觉得属性的方式容易踩坑，完全可以重写WebApplicationFactory的CreateWebHostBuilder方法，手动指定内容根，这样更直观可控：

方法一：使用相对路径 #

public class AppTestFixture : WebApplicationFactory<Startup>
{
    protected override IWebHostBuilder CreateWebHostBuilder()
    {
        // 从测试项目输出目录出发，回到解决方案根再进入Src/WebApp
        var contentRoot = Path.Combine(Directory.GetCurrentDirectory(), "../../../../Src/WebApp");
        
        return WebHost.CreateDefaultBuilder()
            .UseContentRoot(contentRoot)
            .UseStartup<Startup>();
    }
}

方法二：用MSBuild变量获取解决方案根（推荐） #

这种方式不受输出目录影响，更稳定：

首先在测试项目的csproj里添加：

<PropertyGroup>
  <!-- 自动获取解决方案根目录 -->
  <SolutionDir Condition="$(SolutionDir) == '' Or $(SolutionDir) == '*Undefined*'">$(MSBuildProjectDirectory)\..\..\..\</SolutionDir>
</PropertyGroup>
<ItemGroup>
  <!-- 将解决方案根目录写入程序集元数据 -->
  <AssemblyAttribute Include="System.Reflection.AssemblyMetadataAttribute">
    <_Parameter1>SolutionDir</_Parameter1>
    <_Parameter2>$(SolutionDir)</_Parameter2>
  </AssemblyAttribute>
</ItemGroup>

然后在AppTestFixture里读取这个元数据：

public class AppTestFixture : WebApplicationFactory<Startup>
{
    protected override IWebHostBuilder CreateWebHostBuilder()
    {
        var testAssembly = Assembly.GetExecutingAssembly();
        var solutionDirMeta = testAssembly.GetCustomAttributes<AssemblyMetadataAttribute>()
            .FirstOrDefault(a => a.Key == "SolutionDir");
        
        if (solutionDirMeta == null)
            throw new InvalidOperationException("无法获取解决方案根目录");
            
        var contentRoot = Path.Combine(solutionDirMeta.Value, "Src/WebApp");
        
        return WebHost.CreateDefaultBuilder()
            .UseContentRoot(contentRoot)
            .UseStartup<Startup>();
    }
}

最后验证 #

做完上面的调整后，重新运行dotnet test，应该就能正确解析到Src/WebApp目录了。如果还是有问题，可以在测试代码里输出Directory.GetCurrentDirectory()的值，看看当前工作目录是什么，再调整相对路径。

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