.NET Core 3.1 RDLC报表部署Linux Nginx后无法运行求解决方案

• 安装RDLC依赖的Linux系统库
  RDLC在Linux环境下依赖libgdiplus组件，这是本地正常但部署后报错的高频诱因：

  • Debian/Ubuntu系列执行：
    apt-get update && apt-get install -y libgdiplus
    部分64位系统需补充软链接：
    ln -s /usr/lib/libgdiplus.so /usr/lib64/libgdiplus.so
  • CentOS/RHEL系列执行：
    yum install -y libgdiplus

• 修复报表文件的访问权限
  确保Web API运行用户（通常为www-data）拥有RDLC文件及所在目录的读权限：

  chown -R www-data:www-data /path/to/your/report/directory
  chmod -R 644 /path/to/your/report/directory
  

• 规范报表路径的跨平台写法
  避免硬编码Windows风格反斜杠路径，用.NET跨平台API生成路径：

  // 示例：从应用根目录拼接报表路径
  var reportPath = Path.Combine(AppContext.BaseDirectory, "Reports", "YourReport.rdlc");
  

• 启用RDLC的Linux兼容配置
  在报表初始化环节添加兼容设置：

  var localReport = new LocalReport();
  // 开启沙箱权限兼容
  localReport.SetBasePermissionsForSandboxAppDomain(new PermissionSet(PermissionState.Unrestricted));
  // 若使用ReportViewer，补充如下配置
  var reportViewer = new ReportViewer();
  reportViewer.LocalReport.EnableExternalImages = true;
  

• 开启详细日志定位根因
  默认错误信息过于笼统，通过日志获取具体异常：
  在appsettings.json中添加日志配置：

  {
    "Logging": {
      "LogLevel": {
        "Microsoft.Reporting": "Debug",
        "Microsoft.AspNetCore": "Warning"
      }
    }
  }
  

  查看Nginx日志或应用日志文件，定位具体错误（如文件缺失、依赖不足等）。

• 确认发布时文件的复制配置
  在Visual Studio中右键RDLC文件，设置复制到输出目录为如果较新则复制或始终复制，确保发布时文件被正确打包到部署目录。

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