端口会变吗?
以客户端 UI 为准;web-print-pdf 默认自动发现,一般无需写死。
浏览器提示无法连接本地客户端时,多为客户端未启动、端口被占用或安全软件拦截。本文按现象对照排查,配合 错误处理标准 统一提示文案。
| 现象 | 常见原因 |
|---|---|
| getConnectStatus 为 false | 客户端未运行 |
| 连接超时 | 防火墙/杀软拦截 127.0.0.1 |
| 偶发断开 | 客户端休眠、端口变更 |
| 仅某浏览器失败 | 扩展拦截 WebSocket |
以客户端 UI 为准;web-print-pdf 默认自动发现,一般无需写死。
本地 127.0.0.1 WebSocket 通常可用;混合内容策略视浏览器而定。
客户端须在用户 PC 宿主机,不在容器内。
远程打印:不调 npm,服务端按固定格式入队并暴露消费接口,工位客户端填该 URL。见 remote-print。
统一 formatPrintError,见 error-handling 专题。
同一套 web-print-pdf 前端代码可在 Windows、macOS、Linux/信创混合环境运行;请按终端操作系统安装对应客户端。