信创环境 Web 打印:国产浏览器与 Chrome 差异实录

先给结论:信创环境下的网页打印方案只有四条路,能走通的是第三条

信创环境下做网页打印,方案就四条路:原生 window.print()、后端渲染 PDF 再下发、浏览器打印控件(LODOP、ActiveX 那一类)、前端打印设计器 + 标准 Web 打印。前两条能做但不稳,第三条在国产内核上支持度参差不齐,第四条是目前可维护性最好的选择。我们最后落的就是第四条,模板和配置层都在 https://gitee.com/theGreatOldFive/vue-print-designer,代码可以直接抄。

背景很具体:一套已经上线的单据打印页面,Chrome 上跑了半年没出问题,迁到麒麟 + 国产内核浏览器之后冒出四处行为差异,其中两处会让单据打不出来。这节先把选型结论说清楚,后面几节按差异逐条拆。

复盘只讲三件事:哪儿不一样、怎么兜、代码长什么样。不讲生态,不讲赋能。

选型我只看三条硬指标,别的都是次要的:

一、是否依赖插件。 要装控件的方案,在信创终端上第一个卡住的就是分发:几百台机器,浏览器版本、内核版本、权限策略各不相同,装插件这件事本身就要排期。ActiveX 类方案在国产内核上基本走不通,直接排除。

二、是否受内核差异影响。 原生 window.print() 的调用本身没问题,问题在打印预览和分页计算------同一份 A4 单据,Chrome 上一页放得下,国产内核上会多切一页,页脚跑到第二页去。这类差异你改不了,只能绕。

三、出问题能不能自己改。 这条最实在。前两条方案出问题,你只能提工单等内核厂商;第四条方案出问题,改的是自己仓库里的模板 JSON 和打印配置,当天能发版。

按这三条打分,结论很清楚:原生打印受内核影响且不可控;后端 PDF 渲染稳定但改一次版式要动后端、走一次发布,单据字段一多变更是灾难;控件方案在信创终端上分发成本高、支持度参差;前端设计器 + 标准 Web 打印,输出走浏览器标准能力,版式在模板层自己控,出了问题自己改。

落地上就是把打印参数收进配置,不散在业务代码里。比如纸张和边距:

js 复制代码
const printConfig = {
  paper: 'A4',
  orientation: 'portrait',
  margin: { top: 10, right: 8, bottom: 10, left: 8 },
  scale: 1,
  fitToPage: true
}

后面几节讲到的四处差异,兜底最终都收在这一层------模板怎么排、配置怎么给,而不是在每个页面里写 if 判断浏览器。

方案取舍:为什么把打印控件换成了前端模板

四条路线我们都在真实单据上跑过一遍,结论先摆出来:模板归模板,输出归输出,两件事分开做。

方案 A,原生 window.print()。零依赖,代码三行就能跑,问题在控制力。同一张 A4 出库单,Chrome 上页脚落在第一页底部,国产内核上因为默认边距和缩放策略不同,内容多撑出 12mm,页脚被挤到第二页,多出一张空白页。页眉页脚更麻烦,@page 里的 margin 在部分内核上被忽略,打印预览里看着对,实际出纸带 URL 和日期。这些参数不在你手里,调不动。

方案 B,后端生成 PDF。稳定是真稳定,坐标写死,输出永远一致。代价是模板硬编码在服务端,业务方想把"制单人"从右下角挪到右上角,得提需求、改代码、走发布,一周算快的。单据字段一多,改版频率上来,后端同学会被拖死。

方案 C,打印控件。功能最全,纸张、坐标、走纸、连续打印都有。但在信创终端上,安装本身就是项目:几百台机器,浏览器内核版本、驱动、权限策略各不相同,装一遍要排期,出问题要现场排查。更关键的是部分国产内核根本不支持这类插件接口,装了也调不起来。这是长期运维负担,不是一次性投入。

方案 D,前端打印设计器。模板以 JSON 存,业务侧拖拽调整版式,打印走浏览器标准能力,兼容面最大。我们最终用的是 vue-print-designer 的可视化设计器,模板存库,页面只负责取模板、套数据、调打印。

取舍的实质是把两件事拆开:

  • 模板层:版式、字段位置、纸张尺寸,用 JSON 描述,业务方自己维护,改完即时生效,不发版。
  • 输出层:统一收口到一个打印模块,内核差异的兜底全放这里,业务页面不写任何浏览器判断。

配置也集中,不散在页面里:

js 复制代码
const printConfig = {
  paper: 'A4',
  orientation: 'portrait',
  margin: { top: 10, right: 8, bottom: 10, left: 8 },
  scale: 1,
  fitToPage: true
}

从旧控件迁移时注意一点:只保留它的纸张和坐标概念,API 一律不沿用。控件那套 PrintInit、SetPrintMode 之类的调用,和 Web 打印模型对不上,硬兼容只会把两套逻辑搅在一起。把老模板的纸张尺寸、元素坐标读出来,转成设计器的 JSON 结构,一次性迁完,后面就只维护 JSON。

这样后面几节讲的四处内核差异,兜底都落在输出层这一个地方,改一处,全站生效。

坑一:分页与纸张尺寸,毫米和像素不是一回事

同一张 A4 发货单模板,在 Chrome 里预览是一页,到了某国产内核浏览器上,内容溢出到第二页,页脚被挤到第三页;换个内核版本,又变成整页缩小到 80%,四周留白宽得能再放一列字段。模板没改,数据没改,打印机是同一台。

拆开看是三个变量叠加。

一是 @page 支持度。Chrome 对 @page { size: A4; margin: ... } 基本照做,部分国产内核只认一部分属性,size 被忽略,回落到打印机默认纸张;margin 被忽略,回落到浏览器默认边距。你写的 10mm 边距,实际打印出来可能是 12.7mm(0.5 英寸)。

二是浏览器默认缩放。国产内核里不少版本默认勾着"适应页面宽度"或"缩放以适合纸张",用户在打印对话框里看不见,代码也读不到。你在 CSS 里算好的 210mm 宽,被整体乘了个 0.9。

三是 DPI 换算。96px 等于 1 英寸是 CSS 的约定,打印机按物理 DPI 走。模板里只要有一处写死 px 宽度,比如 width: 780px,在不同内核的换算链路上就会漂。

兜底原则只有两条,写进团队规范:

模板内部一律用毫米,不写 px。 纸张、边距、元素宽高、字号间距,全部 mm。px 只出现在屏幕预览的容器上,不进模板。

分页用显式分页符,不靠内容自然溢出。 让浏览器自己判断"这页装不下了"是最不可控的一环,各内核的盒模型取整方式不同,差 1px 就翻页。

css 复制代码
@page {
  size: 210mm 297mm;      /* 显式写宽高,不写 A4 关键字 */
  margin: 0;               /* 边距交给模板内部控制 */
}

.print-page {
  width: 210mm;
  min-height: 297mm;
  padding: 10mm 8mm;
  box-sizing: border-box;
  page-break-after: always;
  break-after: page;
}

.print-page:last-child {
  page-break-after: auto;
  break-after: auto;
}

/* 明细行禁止跨页断开 */
.print-row {
  break-inside: avoid;
  page-break-inside: avoid;
}

注意 @page 的 margin 写 0,边距在 .print-page 的 padding 里给。这样即使某个内核忽略 @page 的 margin,也不会叠加成双倍留白。

纸张尺寸在模板属性里声明,不在页面代码里写。用 它 时,模板 JSON 顶层带 paper 字段,设计器画布按 1mm 一比一渲染,导出时统一换算成打印单位,业务页面拿到的就是一份已经定好纸张的模板:

js 复制代码
const template = {
  paper: { width: 210, height: 297, unit: 'mm' },
  margin: { top: 10, right: 8, bottom: 10, left: 8 },
  elements: [
    { type: 'text', field: 'orderNo', x: 12, y: 14, w: 60, h: 8, unit: 'mm' },
    { type: 'table', field: 'items', x: 8, y: 40, w: 194, h: 200,
      pageBreak: 'row', repeatHeader: true }
  ]
}

表格节点上的 pageBreak: 'row' 表示按行分页,repeatHeader 让表头在每页重出。这两项交给输出层处理,页面里不写任何内核判断。

验收别靠肉眼。同一份模板,在 Chrome、两款国产内核上各打一张,拿尺子量四个边距的实际值,和模板声明的 10/8/10/8 对比,误差控制在 2mm 以内算通过。超了先查 @page 是否被忽略,再查打印对话框里的缩放是不是默认开了。这一步做完再上线,比上线后被业务方拿着歪掉的单据找过来省事。