ASP.NET MVC中Rotativa ViewAsPDF调试与生产环境PDF生成差异问题

1. 图片无法显示 #

• 使用绝对路径引用图片：在.cshtml视图中，将相对路径替换为通过Url.Content生成的绝对路径，确保生产环境能正确解析资源位置：

  <img src="@Url.Content("~/images/your-header-image.png")" alt="Header" />
  

• 确认图片文件的部署属性：在Visual Studio中右键图片文件→属性，设置「复制到输出目录」为「较新时复制」，保证发布时图片文件同步到生产服务器。

2. 表格边框消失、内容错乱 #

• 确保CSS样式正确加载：使用绝对路径引用CSS文件，避免生产环境下相对路径无法解析：

  <link rel="stylesheet" href="@Url.Content("~/css/your-stylesheet.css")" />
  

• 添加打印专用CSS样式，强制表格边框和布局：在样式表中增加打印媒体查询，覆盖可能丢失的样式：

  @media print {
      table {
          border-collapse: collapse !important;
          width: 100% !important;
      }
      table th, table td {
          border: 1px solid #333 !important;
          padding: 8px !important;
      }
  }
  

• 检查Rotativa依赖：Rotativa依赖wkhtmltopdf工具，确保生产服务器已部署对应版本（32/64位匹配服务器系统），或项目中包含正确的Rotativa包及配套可执行文件。
• 调整PDF生成参数：在代码中设置页面边距、方向等参数，避免布局溢出：

  var report = new ViewAsPdf("Details", wC_Inbox)
  {
      FileName = "InitialInbox.pdf",
      PageMargins = new Margins { Top = 15, Bottom = 15, Left = 10, Right = 10 },
      PageOrientation = Orientation.Portrait
  };
  

3. 其他排查点 #

• 验证生产环境视图渲染：直接访问Details视图的URL，确认页面在生产环境中显示正常（表格、图片、样式均正确），排除视图本身的部署问题。
• 检查环境差异：确认生产环境和调试环境的.NET版本、Rotativa版本一致，避免版本兼容问题。

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