.NET Core导出PDF时服务器图片路径报错500问题求助

我基于.NET Core开发文档导出PDF功能，文档包含图片。本地环境下代码能正常获取图片，但部署到服务器后出现500错误，问题出在图片路径上。

相关代码如下：

var path = Path.Combine(_hostingEnvironment.WebRootPath, "images", "EDSignature.png");
_logger.LogInformation($"EDSignature Image {path}");
//var path = _hostingEnvironment.WebRootFileProvider.GetFileInfo("Images/EDSignature.png")?.PhysicalPath;
var EDSignature = Image.GetInstance(path);
//var EDSignature = Image.GetInstance($"{Directory.GetCurrentDirectory()}{@"\wwwroot\images\EDSignature.png"}");

排查与解决方法 #

• 统一路径大小写：服务器文件系统（如Linux）区分大小写，本地Windows不区分。确保代码中路径的大小写和服务器上实际文件夹/文件名完全一致，比如代码用"images"就别在服务器上建"Images"文件夹。
• 改用文件流获取图片：避免依赖物理路径，用WebRootFileProvider读取文件流，适配不同部署场景：

  var fileInfo = _hostingEnvironment.WebRootFileProvider.GetFileInfo("images/EDSignature.png");
  if (fileInfo.Exists)
  {
      using var stream = fileInfo.CreateReadStream();
      var EDSignature = Image.GetInstance(stream);
  }
  else
  {
      _logger.LogError("EDSignature.png不存在，请检查文件路径");
      // 此处添加文件不存在时的降级处理逻辑
  }
  

• 确认文件发布配置：右键EDSignature.png文件→属性→设置复制到输出目录为「始终复制」，确保发布时文件同步到服务器。
• 避免硬编码路径分隔符：不要用@"\wwwroot\images"这种Windows专属分隔符，统一用Path.Combine或/保证跨平台兼容。
• 核对服务器实际路径：根据日志输出的路径，登录服务器直接查看该路径下是否存在图片，同时检查文件权限（确保应用程序有权限读取该文件）。

内容的提问来源于stack exchange，提问作者IR'Shah