wkhtmltopdf 遇到的坑以及填坑指南

  最近公司有一个中的需求,是将html表单转换成pdf 。

  无非方式就只有两种,前端的方式咱就不说了,您能看到这里,必然是采用了市场占有率最高的wkhtmltopdf。

  优缺点都很明显,废话不多说,直接说我踩过的坑和填过的坑。

  No1.  有登陆权限验证的页面需要打印为pdf 。如果你要打印的页面是基于权限认证的,那你打印出来,必然是跳转到认证页面的pdf。

           看到这里,不要懵逼。

          wkhtmltopdf 支持账号密码和验证码登陆,同时也支持采用cookie 的方式进行登陆。大部分时候采用cookies 登陆即可。

          具体的实现方式如下:

ProcessStartInfo psi = new ProcessStartInfo();

psi.FileName = "wkhtmltopdf.exe";

string cookieArgs = "";

var cookies = HttpContext.Current.Request.Cookies;


if (cookies != null)

{

    var sb = new System.Text.StringBuilder();

    // you probably only need the ".ASPXFORMSAUTH"

    // and "ASP.NET_SessionId" cookies

    // but I pass everything just in case

    foreach (string key in cookies.AllKeys)

    {

        string value = cookies[key].Value;

        sb.AppendFormat("--cookie {0} {1} ", key, value);                   

    }

    cookieArgs = sb.ToString();

}

psi.Arguments = urlToPrint + " -q " + cookieArgs + " -";

Process.Start(psi);

 No2.打印的内容不全。 

这时候要分析具体原因,在wkhtmltopdf 里有一个参数是--window-status ,这个参数可以支持ajax异步请求 的。

做法是: 在调用wkhtmltopdf 时,传入参数 ,比如 传入 “   --window-status  completed”   ,然后在ajax 完成回调时 ,也将document 的window.status = "completed",这样的话,就会完全支持异步调用。有两点需要注意:1.每个参数之间必须有空格,不然一定会出现你想到的问题。2.window.status 的值必须与传入的参数值一样,否则的话,就会一直处于等待状态。

No3. 空白页面,网页显示完好无损,但打印出来的却是空白页面。      

     这是最大的一个坑,我研究了一天才踩平了。到现在还有一些疑问的地方,等到时候我在去重新踩 。说一下坑在哪里哈.

      wkhtmltopdf 的工具是基于qt webkit 的。所以基本上目前的流行玩法都是支持的。但特么的也有例外,由于官网已经很久没有更新,我去github上看到的更新也是很久之前的。

     如果是普通的mvc 和html 页面是完全没有问题的。但单页面应用程序的坑就大了。

    我当时用的版本是angular js ,在页面显示完美,但在pdf 打印出来确实空白的。

     起初我认为问题出现在wkhtmltopdf ,它并不支持单页面应用程序。但我用vue 测试的没有问题。于是我重新测试angular js ,我在github 看了每一个提问者的问题。发现一个提问者讲到,他用的angular js  1.4的版本出现了问题,回撤到1.3.5 则正常。于是我发现新大陆一样,将angular js 的版本也回车到了1.3.5 ,发现打印出来的页面不在是空白页面,是有内容的页面。由于我头一次接触angluar js ,我问同事才得知,angluar js 1.4版本跨度比较大,改变了好多的内容,包括请求方式都发生了很大的变化。这也就解释了,为啥使用angular js 打印的是空白页,因为angular js 1.4以上的版本,你用wkhtmltopdf 根本就调用不到后台的内容,压根就不会发起请求。

      别急,到这里,坑还没结束,虽然能请求后端了,但是我发现,打印出来的内容却缺少了很多东西,这时候就尴尬了,angular js 1.4 以上的 渲染的内容没有问题,但不能向后台发起请求,angular js 1.3.5能发起请求,但问题是打印的时候渲染不出内容。 经过我和同事的一步步调试,发现问题竟然在css ,一个叫overflow 的标签直接影响内容。 具体详情请参考前辈的:https://www.jianshu.com/p/57c897cfaa27

    周六折腾了一天,总算是搞定了。希望对大家能有所帮助,如果有什么问题,大家及时留言。我会尽快的帮助大家解决。

你可能感兴趣的:(wkhtmltopdf 遇到的坑以及填坑指南)