Stryker.NET 4.0.1版本中RazorLangVersion参数异常问题分析

在Stryker.NET 4.0.1版本中，部分.NET项目在执行变异测试时遇到了一个关于RazorLangVersion参数的异常问题。这个问题主要影响ASP.NET Web项目，特别是那些并不包含任何Razor文件的应用程序。

问题现象

当用户将项目从Stryker.NET 4.0.0升级到4.0.1版本后，在执行变异测试时会遇到以下错误信息：

Failed to generate source code for mutated assembly: error RZ3600: Invalid value ''' for RazorLangVersion. Valid values include 'Latest' or a valid version in range 1.0 to 8.0.

值得注意的是，这个错误出现在不包含任何Razor文件的.NET 6 Azure应用服务项目中。问题在Linux构建服务器上出现，但在Windows 11本地环境中运行正常。

问题根源

经过技术团队分析，这个问题源于Stryker.NET对代码分析器和生成器的支持机制。在.NET Web项目中，即使没有显式引用Razor文件，SDK也会默认加载三个源代码生成器：

1. JsonSourceGenerator
2. LoggerMessageGenerator
3. RazorSourceGenerator

问题的核心在于RazorSourceGenerator需要一个有效的RazorLangVersion参数才能正常工作。在Stryker.NET 4.0.0版本中，由于使用的是较旧版本的Roslyn编译器，Razor代码生成器根本无法加载，因此不会出现这个错误。而在4.0.1及更高版本中，生成器能够加载但会因为缺少必要的配置参数而失败。

技术背景

Razor是ASP.NET中的一种视图引擎，用于将服务器端代码与HTML标记混合。RazorLangVersion参数用于指定项目使用的Razor语言版本。虽然很多项目并不直接使用Razor，但由于.NET Web SDK的默认配置，Razor相关的生成器仍然会被加载。

在正常的项目构建过程中，构建系统会自动为RazorSourceGenerator提供必要的参数。但在Stryker.NET的变异测试环境下，这些参数需要显式传递，而当前版本尚未完全实现这一机制。

解决方案

Stryker.NET团队已经意识到这个问题，并提出了两种解决方案：

1. 对于不使用Razor的项目：允许继续执行变异测试，即使Razor生成器初始化失败。这不会影响实际测试结果，因为项目本身并不依赖Razor功能。

2. 对于使用Razor的项目：需要完善参数传递机制，确保RazorSourceGenerator能够获取到必要的配置信息。这需要更深入的技术调研，因为微软官方关于代码分析器和生成器调用机制的文档相对有限。

临时解决方案

对于遇到此问题的用户，可以考虑以下临时解决方案：

1. 暂时回退到Stryker.NET 4.0.0版本
2. 等待官方发布包含修复的新版本
3. 在项目中显式设置RazorLangVersion属性（虽然对非Razor项目来说这并非理想方案）

总结

这个问题展示了变异测试工具在处理复杂构建系统时的挑战。Stryker.NET团队正在积极解决这个问题，未来版本将提供更完善的代码生成器支持机制。对于大多数不涉及Razor的项目来说，这个问题不会影响最终的变异测试结果，只是会在构建过程中产生错误信息。