Blazor WASM引用RCL DLL时无法加载静态资源求助

核心问题：Blazor WASM 9主项目引用RCL的Release版DLL时，wwwroot下的静态资源（CSS/JS）无法通过_content/Common.Resources/...路径访问，报404错误，但项目引用时正常，组件功能不受影响。

1. 检查RCL项目的.csproj配置 #

打开Common.Resources的.csproj文件，确保静态资源的编译配置正确：

<PropertyGroup>
  <!-- 强制静态资源映射前缀与包名/项目名一致 -->
  <StaticWebAssetsBasePath>Common.Resources</StaticWebAssetsBasePath>
  <!-- 启用默认内容项，自动识别wwwroot下的文件 -->
  <EnableDefaultContentItems>true</EnableDefaultContentItems>
  <!-- 生成静态资源清单文件 -->
  <GenerateStaticWebAssetsManifest>true</GenerateStaticWebAssetsManifest>
</PropertyGroup>

<ItemGroup>
  <!-- 确保wwwroot下所有文件被标记为内容资源 -->
  <Content Include="wwwroot\**\*" />
</ItemGroup>

这个配置会让RCL编译时自动将wwwroot资源嵌入DLL，并生成正确的映射清单。

2. 确保DLL与清单文件配套 #

当手动引用RCL的Release版DLL时，必须将Common.Resources.staticwebassets.endpoints.json文件与DLL放在同一目录下，并在主项目中设置：

• 右键DLL引用，将Copy Local设为True
• 对清单文件做相同设置（若手动添加了文件引用）

主项目需要读取这个清单文件来解析_content/路径的资源映射，缺失会导致404。

3. 验证资源是否嵌入DLL #

用ILSpy等工具打开RCL的DLL，查看是否包含wwwroot下的CSS/JS文件。如果看不到，说明编译时资源未被嵌入，回到第一步检查csproj配置。

4. 清理重建解决方案 #

• 删除主项目和RCL的bin/obj目录
• 重新编译RCL为Release版本
• 重新添加DLL引用到主项目，再完整重建主项目

5. 确认资源路径正确性 #

确保主项目index.html中的资源路径完全匹配：

<link href="_content/Common.Resources/css/site.min.css" rel="stylesheet" />
<script src="_content/Common.Resources/js/site.min.js"></script>

禁止省略_content/前缀，或写错项目/包名称。

内容的提问来源于stack exchange，提问作者Mc van Staaden