OpenSolutionAsync报错：.NET Framework 4.8/4.7.2找不到Wave16_8字段

问题根本原因 #

这个System.MissingFieldException报错是由MSBuild版本不兼容导致的：Microsoft.Build.Utilities.ChangeWaves.Wave16_8字段是MSBuild 16.8及以上版本才新增的，你当前.NET Framework 4.8环境中加载的MSBuild版本低于16.8，或是高版本的Roslyn（Microsoft.CodeAnalysis）包与旧版MSBuild不匹配，就会触发该字段找不到的异常。

解决方法 #

• 降级NuGet包版本：所有Microsoft.CodeAnalysis.*开头的包、Microsoft.Build.Locator包统一降级到3.x版本（推荐3.11.0），更高的4.x/5.x版本主要面向.NET Core/.NET 5+生态，对.NET Framework 4.8的兼容性极差，是导致该问题的最常见诱因。
• 替换MSBuild注册逻辑：不要使用默认注册方法MSBuildLocator.RegisterDefaults()，改为主动筛选符合版本要求的MSBuild实例注册，避免自动加载到旧版MSBuild，参考代码：

var vsInstances = MSBuildLocator.QueryVisualStudioInstances().ToList();
// 筛选版本 >=16.8的MSBuild实例，优先选最高版本
var validInstance = vsInstances.OrderByDescending(i => i.Version)
                               .FirstOrDefault(i => i.Version.Major >= 16 && i.Version.Minor >= 8);
if (validInstance == null)
{
    throw new InvalidOperationException("当前环境未找到MSBuild 16.8及以上版本实例");
}
MSBuildLocator.RegisterInstance(validInstance);

• 调整项目平台配置：将你的项目设置为优先运行在32位（x86）模式下：右键项目 -> 属性 -> 生成 -> 勾选「首选32位」，或是直接将平台目标设置为x86。Visual Studio自带的.NET Framework版MSBuild默认是32位程序，64位运行的程序会无法识别该MSBuild实例，反而加载到.NET Core版的MSBuild触发兼容问题。
• 检查开发环境依赖：确认本机安装了Visual Studio 2019 16.8及以上版本，且已安装「.NET桌面开发」工作负载，保证存在符合版本要求的.NET Framework版MSBuild。

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