如何从服务器端引用Razor类库（RCL）中的资源？

问题根源 #

开发阶段RCL类库的wwwroot资源不会自动同步到Blazor Server项目的运行目录，而发布时构建流程会自动处理资源复制，导致开发环境下服务器端找不到资源路径。

通用解决步骤 #

1. 配置RCL项目，强制资源复制到输出目录 #

编辑RCL项目的.csproj文件，添加以下配置，确保开发编译时资源也会被复制到Server项目的bin目录：

<ItemGroup>
  <Content Update="wwwroot/**/*">
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
    <CopyToPublishDirectory>PreserveNewest</CopyToPublishDirectory>
  </Content>
</ItemGroup>

此配置会保持RCL资源与输出目录同步，新增或修改资源时自动更新。

2. 在Blazor Server中映射静态文件路径 #

在Program.cs中，添加RCL资源的静态文件映射，让服务器端能识别/_content/[RCL项目名]的请求路径：

app.UseStaticFiles();

// 替换为你的RCL项目名称和.NET版本
var rclContentPath = Path.Combine(Directory.GetCurrentDirectory(), "bin", "Debug", "net8.0", "wwwroot");
app.UseStaticFiles(new StaticFileOptions
{
    FileProvider = new PhysicalFileProvider(rclContentPath),
    RequestPath = "/_content/SharedResources"
});

注意：SharedResources替换为你的RCL项目名称，net8.0替换为项目使用的.NET版本（如net6.0、net7.0）。

3. 统一资源引用方式 #

无论客户端还是服务器端，都使用/_content/[RCL项目名]/[资源相对路径]作为通用引用路径：

• 客户端Razor组件中引用：

  <img src="/_content/SharedResources/images/logo.png" alt="Logo" />
  

• 服务器端代码中读取资源：

  var resourcePath = Path.Combine(Directory.GetCurrentDirectory(), "_content", "SharedResources", "images", "logo.png");
  if (File.Exists(resourcePath))
  {
      var resourceBytes = await File.ReadAllBytesAsync(resourcePath);
      // 处理资源逻辑
  }
  

额外注意事项 #

• 确保Blazor Server项目已添加对RCL的项目引用（而非NuGet包引用，开发阶段NuGet包不会实时同步资源）
• 配置完成后清理解决方案并重新构建，确保资源被正确复制
• 如果使用.NET 6+，静态文件配置需放在app.UseRouting()之前、app.Run()之前

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