Rotativa生成PDF时Bootstrap样式失效问题求助

我之前也碰到过一模一样的情况——用Rotativa生成PDF时，Bootstrap的类完全不生效，只有内联CSS能起作用，试了各种路径加载都没用。下面几个亲测有效的解决办法，你可以逐个尝试：

1. 用绝对路径加载Bootstrap CSS #

Rotativa底层的wkhtmltopdf对相对路径的资源支持很差，换成绝对路径就能解决大部分问题。你可以在视图里用Url.Content()生成正确的绝对路径：

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

或者直接用服务器物理路径（注意Windows系统要加file:///前缀）：

<link href="file:///@Server.MapPath("~/Content/bootstrap.min.css")" rel="stylesheet" />

2. 将Bootstrap CSS内联到视图中 #

如果绝对路径还是不行，最稳妥的办法就是把Bootstrap的CSS内容直接内联到视图里。虽然会让视图代码变臃肿，但能确保wkhtmltopdf100%读取到样式：

@{
    // 读取本地Bootstrap CSS文件内容
    var bootstrapCss = System.IO.File.ReadAllText(Server.MapPath("~/Content/bootstrap.min.css"));
}
<style>
    @bootstrapCss
</style>

或者你也可以直接把bootstrap.min.css的全部内容复制粘贴到<style>标签里。

3. 配置Rotativa的CustomSwitches参数 #

给ActionAsPdf加上一些自定义开关，让wkhtmltopdf更好地处理外部资源和样式：

public ActionResult PrintPDF(string assemblyOrderID)
{
    return new ActionAsPdf("PrintableView", new { assemblyOrderID = assemblyOrderID })
    {
        CustomSwitches = "--load-error-handling ignore --enable-javascript --disable-smart-shrinking"
    };
}

这些开关的作用：

• --load-error-handling ignore：忽略资源加载错误，避免因为某个资源加载失败导致整个样式失效
• --enable-javascript：启用JavaScript（部分Bootstrap组件依赖JS，但纯CSS样式其实不需要，不过开着没坏处）
• --disable-smart-shrinking：禁用wkhtmltopdf的自动收缩功能，防止它篡改你的布局

4. 去掉Layout，直接写完整的HTML结构 #

你当前在局部视图里引用了Layout，但如果Layout里的样式路径也是相对的，同样会出问题。不如直接在局部视图里写完整的HTML头部，脱离Layout的干扰：

@{ Layout = null; }
<!DOCTYPE html>
<html>
<head>
    <meta charset="utf-8" />
    <title>Materialschein</title>
    <link href="@Url.Content("~/Content/bootstrap.min.css")" rel="stylesheet" />
</head>
<body>
    <!-- 你的原有视图内容 -->
    @if (Model != null) {
        <div class="container">
            <!-- ... 剩余内容 ... -->
        </div>
    }
</body>
</html>

额外注意点 #

• Bootstrap版本兼容：如果用的是Bootstrap 4+，旧版本的wkhtmltopdf可能不支持CSS变量等新特性，试试换成Bootstrap 3.x版本测试一下。
• 文件权限检查：确保服务器上的bootstrap.min.css文件存在，且wkhtmltopdf进程有读取该文件的权限。
• 先测试基础案例：先写一个只包含Bootstrap基础布局的简单视图（比如你提到的row和cols示例），用Rotativa生成PDF，确认样式生效后再迁移到你的业务视图。

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