安装.NET 7预览版导致MAUI项目构建失败

问题概述 #

安装.NET 7预览版后，.NET MAUI项目无法正常构建调试，卸载预览版并清理bin/obj文件后仍触发以下报错：

'{directory}/project.assets.json' 没有针对'net6.0-android'的目标，请确保已执行还原且项目TargetFrameworks包含该目标（路径：C:\Program Files\dotnet\sdk\6.0.400\Sdks\Microsoft.NET.Sdk\targets\Microsoft.PackageDependencyResolution.targets 267）

尝试dotnet restore、卸载重装.NET组件后，出现新错误：无法启动调试，启动项目无法启动。卸载重装Visual Studio和.NET后短暂恢复正常，但后续问题复现，还伴随其他异常：

• obj\Debug\net6.0-android\android-arm64\staticwebassets.build.json 清单文件未找到（路径：C:\Program Files\dotnet\sdk\6.0.401\Sdks\Microsoft.NET.Sdk.Razor\targets\Microsoft.NET.Sdk.Razor.StaticWebAssets.targets）
• 调试目标中无Android选项
• 关联问题：.NET MAUI Blazor Android平台无法点击任何元素，报错No package ID ff found for ID 0xffffffff

修复步骤 #

1. 彻底清理.NET环境残留 #

• 打开控制面板 > 程序和功能，卸载所有.NET 7预览版SDK/运行时，以及所有版本的.NET SDK、运行时（包括6.x系列）
• 删除以下目录的全部内容：
  • C:\Program Files\dotnet\sdk
  • C:\Program Files\dotnet\shared
  • C:\Program Files\dotnet\host
  • C:\Users\<你的用户名>\.nuget\packages
• 删除项目根目录下的.vs、bin、obj文件夹

2. 重新安装稳定版.NET与Visual Studio #

• 下载并安装稳定版.NET 6.0 SDK（推荐6.0.401版本），安装时取消所有预览版相关选项
• 重新安装Visual Studio 2022，选择.NET Multi-platform App UI开发工作负载，确保勾选所有Android相关组件（Android SDK、Android NDK、Android Emulator等）
• 安装完成后，打开命令提示符执行dotnet --list-sdks，确认仅存在.NET 6.0的稳定版本

3. 校验并修复项目配置 #

• 打开项目的.csproj文件，确认<TargetFrameworks>节点包含net6.0-android，示例配置：

<TargetFrameworks>net6.0-android;net6.0-ios;net6.0-maccatalyst</TargetFrameworks>
<TargetFrameworks Condition="$([MSBuild]::IsOSPlatform('windows'))">$(TargetFrameworks);net6.0-windows10.0.19041.0</TargetFrameworks>

• 在项目根目录执行dotnet restore，等待依赖包完全还原

4. 解决StaticWebAssets缺失错误 #

• 右键项目 > 属性 > 生成 > 取消勾选启用静态Web资产，保存后重新构建项目
• 若仍报错，手动创建缺失的目录：obj\Debug\net6.0-android\android-arm64，再执行dotnet build

5. 恢复Android调试选项 #

• 打开Visual Studio > 工具 > Android > Android SDK管理器，检查Android SDK Build-Tools版本（建议33.0.0），更新所有必要组件
• 重启Visual Studio并重新加载项目，检查调试目标下拉菜单是否恢复Android选项

6. 修复Blazor点击异常问题 #

• 打开Platforms/Android/MainActivity.cs，确保MainActivity继承自MauiAppCompatActivity，而非原生AppCompatActivity
• 暂时移除项目中的第三方插件，排查是否为插件导致的包ID冲突问题

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