使用IncrementalGenerator时单元测试报错：System.Text.Json中找不到Nodes

核心原因分析 #

1. 测试项目框架/依赖版本不兼容 #

JsonNode是.NET 6及后续版本System.Text.Json的内置类型，若测试项目存在以下情况，必然会触发"找不到Nodes"的异常：

• 目标框架低于.NET 6（如.NET 5、.NET Core 3.1或.NET Framework）
• 引用的System.Text.Json NuGet包版本低于6.0.0

2. 增量生成器未被测试项目正确识别 #

增量生成器的代码是编译时动态生成的，若测试项目未正确配置引用，生成的扩展方法不会被纳入测试编译流程：

• 仅引用生成器项目的dll文件，而非通过项目引用关联
• 缺少MSBuild配置项，未将生成器标记为编译时分析器
• 生成的代码未被测试项目的编译系统捕获

3. 生成器代码的类型引用错误 #

若生成器代码中JsonNode的命名空间引用错误（比如误写为System.Text.Json而非System.Text.Json.Nodes），或生成的扩展方法签名存在问题，会导致测试代码无法绑定到生成的方法，间接引发类型查找异常。

分步解决办法 #

1. 统一目标框架与依赖版本 #

打开测试项目的.csproj文件，做以下确认：

• 目标框架设置为.NET 6+：

  <TargetFramework>net6.0</TargetFramework>
  <!-- 可根据实际需求选择net7.0/net8.0 -->
  

• 确保System.Text.Json版本与主项目一致且不低于6.0.0：

  <PackageReference Include="System.Text.Json" Version="6.0.0" />
  

2. 正确配置生成器项目引用 #

如果生成器是独立类库，测试项目必须通过项目引用关联，并添加必要的MSBuild配置：

<ProjectReference Include="..\YourGeneratorProject\YourGeneratorProject.csproj">
  <OutputItemType>Analyzer</OutputItemType>
  <ReferenceOutputAssembly>true</ReferenceOutputAssembly>
</ProjectReference>

• <OutputItemType>Analyzer</OutputItemType>：告知MSBuild该项目包含编译时增量生成器
• <ReferenceOutputAssembly>true</ReferenceOutputAssembly>：确保生成器的二进制文件和动态生成的代码都被测试项目引用

3. 校验生成器代码的类型引用 #

打开生成器代码，确认JsonNode的命名空间引用正确：

using System.Text.Json.Nodes; // JsonNode的正确命名空间

同时检查生成的扩展方法签名是否符合规范，例如：

public static class JsonNodeExtensions
{
    public static T? GetValue<T>(this JsonNode node, [JsonPathAccessor] string path)
    {
        // 生成的实现逻辑
    }
}

确保测试代码中已添加该类所在命名空间的using语句。

4. 检查测试项目编译配置 #

确认测试项目的.csproj包含必要的编译设置：

• 语言版本设置为C# 9.0及以上（增量生成器的最低要求）：

  <LangVersion>9.0</LangVersion>
  

• 若生成器使用了预览API，需添加：

  <EnablePreviewFeatures>true</EnablePreviewFeatures>
  

5. 清理重建解决方案 #

执行以下操作确保编译状态干净：

1. 清理解决方案：

   dotnet clean
   

2. 重新编译所有项目：

   dotnet build
   

3. 运行单元测试：

   dotnet test
   

额外排查方向 #

• 若异常在运行时抛出，检查测试代码中JsonNode的初始化是否正确：

  var jsonNode = JsonNode.Parse("{\"name\":\"test\"}"); // 正确的初始化方式
  

• 查看生成器输出：在测试项目的obj/Debug/netX.0/generated/目录下找到生成的代码文件，确认代码是否正确生成且包含正确的类型引用。

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