移动审批上线,门店报损单也在手机上填了。业务很高兴,直到有人点了「打印」——安卓上偶尔弹个框,iPhone 上直接当没这回事,PC 端钉钉能弹,但打出来永远是那台默认机。
直说吧:
这跟你的前端框架没关系,是容器的事。移动端的 WebView 里,window.print 基本不存在——Android WebView 要 App 自己接 PrintManager,iOS 的 WKWebView 和 Safari 也不支持 window.print。你在 H5 里装十个打印库,也变不出这个能力。
所以移动端的打印,第一步不是「怎么写代码」,而是「这张纸从哪台机器出来」。
先认清四端的真实能力
| 环境 | window.print | 能指定打印机 | 能静默 |
|---|---|---|---|
| 钉钉/企微 移动端 | 基本没有 | 不能 | 不能 |
| 手机浏览器(iOS) | 没有 | 不能 | 不能 |
| PC 钉钉 / 企微 | 通常可以(内嵌 Chromium) | 不能 | 不能 |
| PC 浏览器 | 可以 | 不能 | 不能 |
看最后两行:即使能弹框,也指定不了打印机。所以「在 H5 里让纸出来」这个方向,从根上就不成立。
三条能落地的路
一、容器 JSAPI 调系统打印。 钉钉、企微都有一点 JSAPI,能调起系统面板或分享。结果是:还是弹框,还是只能默认机,而且不同版本行为不一致。它能解决「点得动」,解决不了「打得对」。
二、把出纸动作放回工位机。 手机只负责提交任务,门店那台收银机/一体机收到任务,本地静默出纸。这是门店场景最常见也最稳的做法。
三、云打印。 打印机联网,平台直接推。代价是换设备、数据出内网,前面单开一篇说过,这里不重复。
第二条路怎么写
手机端不产生纸,只发一条「该打单了」的指令。工位机收到后,用登录态去拉单据页面,本地出纸——工位那一侧用 web-print-pdf 把 URL 渲成 PDF,再交给系统打印栈:
import webPrintPdf from 'web-print-pdf';
// 这段跑在工位机上,不是手机上
await webPrintPdf.printHtmlByUrl(
'https://oa.internal/stock/loss/print?id=20261120001',
{
paperFormat: 'A5', printBackground: true },
{
printerName: '门店-01-小票' },
{
cookies: {
SESSION: workseatSession }, // 内网报表通常要登录态
requestTimeout: 30,
}
);
为什么用 printHtmlByUrl 而不是让手机把 HTML 传过来?因为单据的样式、权限、字体都在工位机那一侧,手机只管「哪一单、哪台机」。传 HTML 会让手机变成渲染终端,字体和纸宽全要重做一遍。
三个必须先想清楚的问题
- 手机和工位怎么对应。 门店号?工位号?还是扫码绑定?没有映射关系,任务就会满世界乱打;
- 工位机拉内网 URL 的登录态。 大多数内网报表页要 session,要么带 cookie,要么让后台开一个短时效的打印专用令牌;
- 跨网段。 手机在 4G,工位在门店内网,中间得有一层服务端转发,别指望手机直连工位。
排障表
| 现象 | 先查 |
|---|---|
| 手机上点了完全没反应 | 本来就是 WebView 不支持,别再改前端代码 |
| 手机上弹了框,打出来是空白 | 内容依赖懒加载/图片,window.print 触发太早 |
| PC 钉钉能弹,但只能默认机 | 容器只给了系统对话框,指定不了,换第二条路 |
| 门店打出来的小票是 A4 | 纸张尺寸没传,或者客户端没装对应纸型 |
| 任务发出去了,工位没动静 | 工位客户端没起、或门店映射配错 |
移动端只解决「在哪点」,不解决「谁出纸」。把这两件事分开,方案反而简单:H5 做入口,工位机做执行,中间一条能对账的任务。