Blazor WASM添加程序集引用失败：MSB3954错误求助

错误详情 #

Error MSB3954 Failed to compute hash for file 'NorwestStudentPlan.Shared' because it does not exist or is inaccessible. NorwestActivity.Client C:\Users\nconnect.nuget\packages\microsoft.net.sdk.webassembly.pack\8.0.4\build\Microsoft.NET.Sdk.WebAssembly.Browser.targets 356

• 仅NorwestStudentPlan.Shared.dll触发报错，StudentManagementLibrary.dll无异常
• 删除构建文件夹中除目标DLL外的其他文件（如DocumentFormat.OpenXml.dll）后，解决方案可正常构建
• 业务上需要从wwwroot目录引用程序集，用于发布后供其他项目读取

原因解析 #

这个错误的本质是WebAssembly打包工具在处理程序集依赖时出现了关联错误，具体到你的场景：

1. 依赖版本冲突：DocumentFormat.OpenXml.dll和NorwestStudentPlan.Shared.dll的依赖版本不匹配，打包工具解析依赖链时，错误地将某个不存在的文件路径绑定到了NorwestStudentPlan.Shared，导致哈希计算失败。
2. 文件占用/权限问题：第三方DLL（比如OpenXml的DLL）在构建过程中被其他进程锁定，导致打包工具无法完整扫描NorwestStudentPlan.Shared.dll的依赖树，进而抛出“文件不存在或无法访问”的错误。
3. WASM打包逻辑特性：.NET 6 Blazor WASM的打包工具（Microsoft.NET.Sdk.WebAssembly.Browser.targets）在处理wwwroot中的程序集时，会校验所有关联依赖的可用性。如果某依赖的哈希计算失败，工具会将错误指向第一个被扫描的主程序集，而非真正出问题的依赖文件。

解决方法 #

1. 彻底清理后重建 #

• 右键解决方案，选择清理解决方案
• 手动删除所有项目的bin、obj文件夹，以及wwwroot下的第三方程序集
• 重新构建解决方案，确保所有依赖从NuGet或项目引用正确复制到输出目录

2. 统一依赖版本 #

• 打开解决方案的管理NuGet程序包，检查DocumentFormat.OpenXml在所有项目中的版本是否一致
• 将NorwestStudentPlan.Shared和Blazor Client项目中的DocumentFormat.OpenXml版本统一为同一稳定版

3. 规范程序集引用方式 #

• 避免手动复制程序集到wwwroot，改为通过项目引用管理NorwestStudentPlan.Shared：
  1. 在Blazor Client项目右键 → 添加项目引用，勾选NorwestStudentPlan.Shared项目
  2. 确保该引用的复制本地属性设为True（右键引用 → 属性 → 复制本地）
• 如果必须从wwwroot加载，在Blazor Client项目的.csproj中添加以下配置，明确指定要打包的程序集并排除干扰文件：

<ItemGroup>
  <WasmFilesToIncludeInFileSystem Include="wwwroot\NorwestStudentPlan.Shared.dll" />
  <WasmFilesToExcludeFromFileSystem Include="wwwroot\DocumentFormat.OpenXml.dll" />
</ItemGroup>

4. 临时关闭哈希校验（仅应急用） #

如果上述方法无效，可在Blazor Client项目的.csproj中添加以下配置，关闭打包工具的哈希校验：

<PropertyGroup>
  <WasmEnableHashFileValidation>false</WasmEnableHashFileValidation>
</PropertyGroup>

注意：此设置会降低构建安全性，建议解决依赖冲突后恢复默认值。

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