迁移.NET Framework至.NET6 类库引用后报MC1000未知生成错误

问题特征 #

• 发生场景：.NET Framework 4.8项目迁移至.NET 6过程中
• 错误编码：MC1000未知生成错误
• 核心报错：Could not find type 'System.Web.PreApplicationStartMethodAttribute' in assembly 'C:\Program Files\dotnet\packs\Microsoft.NETCore.App.Ref\6.0.5\ref\net6.0\System.Web.dll'
• 触发规律：面向net6.0-windows的公共复用类库单独编译无报错，被同目标框架的WPF项目引用时，编译阶段触发上述错误。

根因说明 #

System.Web.PreApplicationStartMethodAttribute是.NET Framework下ASP.NET专属的启动钩子特性，.NET 6自带的System.Web.dll仅做了极小部分兼容，并未包含该类型。
WPF项目编译时会执行XAML标记编译流程，会扫描所有引用程序集的全局特性元数据；公共类库单独编译时不会触发WPF专属的编译步骤，因此不会报错。当类库中残留该特性的元数据引用时，WPF标记编译器会到.NET 6的System.Web.dll中查找对应类型，找不到就抛出MC1000错误。

排查解决步骤 #

• 第一步：清理残留的程序集特性
  打开公共类库下的Properties/AssemblyInfo.cs文件，全局搜索PreApplicationStartMethod关键字，找到对应的assembly级特性声明直接删除，该特性在.NET 6的WPF、桌面类库场景下无任何作用。
• 第二步：排查无效引用
  打开公共类库的.csproj项目文件，检查是否存在旧框架遗留的System.Web直接引用，类似如下配置直接删除：

  <Reference Include="System.Web" />
  

  同时梳理所有项目引用、NuGet包依赖，卸载所有仅支持.NET Framework、未适配.NET 6的Web相关组件，将第三方依赖全部升级到支持.NET 6的版本，移除项目中实际未使用的冗余依赖。
• 第三步：兼容不可替换的第三方依赖
  如果存在无法升级、内部确实引用了该特性的第三方组件，可以在WPF入口项目中手动定义缺失的类型，让编译流程可以正常扫描到类型，参考代码如下：

  using System;
  
  namespace System.Web
  {
      [AttributeUsage(AttributeTargets.Assembly, AllowMultiple = true)]
      internal sealed class PreApplicationStartMethodAttribute : Attribute
      {
          public PreApplicationStartMethodAttribute(Type type, string methodName)
          {
              Type = type;
              MethodName = methodName;
          }
  
          public Type Type { get; }
          public string MethodName { get; }
      }
  }
  

  该定义仅用于通过编译检查，实际运行时WPF项目不会执行ASP.NET相关的启动逻辑，不会产生功能异常。
• 第四步：清理编译缓存
  所有关联项目执行清理操作，手动删除解决方案根目录、各项目目录下的bin、obj文件夹，重启Visual Studio后重新编译，避免旧的编译缓存导致错误复现。

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