Blazor发布后无法从类库加载图片：如何实现开发与测试环境的动态路径适配？

这个问题的核心是硬编码的相对路径依赖于运行时的工作目录，而开发环境和测试服务器的工作目录、资源部署路径完全不同，导致文件找不到。下面是具体的解决步骤，能同时适配两种环境：

1. 避免硬编码路径，使用ASP.NET Core的Web根目录资源访问机制 #

Blazor类库的wwwroot资源在部署后会被自动复制到主应用的wwwroot/_content/Blazor.Components/目录下，开发环境中ASP.NET Core也会通过这个虚拟路径映射到类库的wwwroot。我们可以利用IWebHostEnvironment来统一获取资源，不管是开发还是部署都能正确定位。

步骤1：在主项目中注入IWebHostEnvironment #

在Blazor Server的组件或服务中，注入IWebHostEnvironment来获取Web根目录的文件提供器：

@inject IWebHostEnvironment WebHostEnv

或者在后台服务/控制器中通过构造函数注入：

private readonly IWebHostEnvironment _webHostEnv;

public YourComponent(IWebHostEnvironment webHostEnv)
{
    _webHostEnv = webHostEnv;
}

步骤2：通过文件提供器获取图片流（推荐） #

不要直接使用文件路径，而是通过WebRootFileProvider读取图片的流，这样能绕过物理路径的差异：

// 类库资源的虚拟路径，开发和部署都统一用这个格式
var imageVirtualPath = "_content/Blazor.Components/Images/Logo.png";
var fileInfo = _webHostEnv.WebRootFileProvider.GetFileInfo(imageVirtualPath);

if (!fileInfo.Exists)
{
    // 处理文件不存在的情况，比如抛出异常或使用默认图
    throw new FileNotFoundException("Logo图片未找到", imageVirtualPath);
}

// 读取文件流，传递给PDF生成组件
using var imageStream = fileInfo.CreateReadStream();

步骤3：修改类库的PDF生成代码接收流 #

把类库中原来的FromFile改为FromStream，这样不需要依赖物理路径：

// 类库中的核心代码修改为接收流
Image image = section.Headers.Primary.AddImage(ImageSource.FromStream(() => imageStream));

注意：如果流的生命周期需要跨方法调用，建议传递Func<Stream>来延迟创建流，避免流提前被释放。

2. 备选方案：拼接正确的物理路径（不推荐，但如果必须用路径） #

如果一定要使用文件路径而不是流，可以通过WebRootPath拼接出正确的物理路径：

var imagePhysicalPath = Path.Combine(
    _webHostEnv.WebRootPath,
    "_content",
    "Blazor.Components",
    "Images",
    "Logo.png"
);

// 传递这个路径给类库的PDF生成代码

这种方式也能适配两种环境：

• 开发时：WebRootPath是主项目的wwwroot路径，拼接后会指向类库资源的映射路径
• 部署时：WebRootPath是测试服务器上的C:\Webservice\application\wwwroot，拼接后正好是C:\Webservice\application\wwwroot\_content\Blazor.Components\Images\Logo.png

3. 额外注意事项 #

• 不要依赖工作目录：绝对不要用..\这类相对路径，因为工作目录在开发（通常是项目文件夹）和部署（通常是服务器的应用根目录）时完全不同。
• 类库资源的打包验证：部署前确认类库的wwwroot资源已经被正确打包到主应用的_content目录下，可以通过查看服务器上的wwwroot/_content/Blazor.Components目录是否存在Images/Logo.png来验证。
• 权限问题：确保测试服务器的应用进程有读取wwwroot/_content/Blazor.Components/Images目录的权限，避免因权限不足导致的文件找不到错误。

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