.NET 8.0发布Blazor WebAssembly AOT失败：无法打开镜像文件

架构老林

2026-7-4

.NET 8 Blazor WebAssembly AOT发布失败问题排查方案

检查项目路径是否包含特殊字符/空格
报错提示无法读取项目文件，若项目所在路径有中文、空格或特殊符号，AOT编译工具可能无法正确解析路径。建议将项目迁移到纯英文无空格的路径下，例如C:\Projects\ProjectTest。
修复WASM工具工作负载
执行命令修复损坏的工作负载文件：
```
dotnet workload repair wasm-tools
```
相较于install命令，repair会重新校验并修复工作负载的安装完整性。
核对项目文件的AOT配置
打开项目的.csproj文件，确保AOT编译配置正确，无冲突项：
```
<PropertyGroup>
  <RunAOTCompilation>true</RunAOTCompilation>
</PropertyGroup>
```
同时检查是否存在与AOT编译冲突的配置项（如部分自定义编译开关），暂时注释后重新尝试发布。
清理NuGet缓存并重新还原
执行命令清理全局NuGet缓存：
```
dotnet nuget locals all --clear
```
进入项目目录后重新还原依赖：
```
dotnet restore
```
避免缓存的旧版本包导致版本冲突。
更新.NET 8 SDK至最新稳定版
执行dotnet --version查看当前SDK版本，若不是8.0系列的最新稳定版，下载安装官方最新版.NET 8 SDK，早期版本的SDK存在AOT编译的已知兼容性问题。