JSON 自动生成 FastReport 数据集：一个中间件搞定内网、云端、物联网全场景打印

无需手写数据绑定代码，一套 JSON 同时支持 HTTP 同步与 MQTT 异步打印，适配本地、云端、分布式全场景

前言

做企业系统、MES、ERP、SaaS云端项目开发，报表打印模块几乎是每个开发者都会头疼的刚需，行业内普遍存在两大痛点：

痛点一：报表开发冗余繁重，改动成本极高

常规报表开发，每新增一张业务单据，都需要手动编写数据源、绑定报表字段、处理明细循环、调试打印格式。一旦前端业务字段调整、单据样式改版，后端代码必须同步改动，重复工作量大，维护成本居高不下。

痛点二：内网/云端场景割裂，需要维护两套打印方案

市面上绝大多数打印工具只支持单一通信协议：内网系统只用HTTP，云端分布式项目只用MQTT。

项目一旦同时涉及内网工位打印、全国门店远程打印、工业工控跨网打印，就需要对接两套打印服务、维护两套报表逻辑，开发和运维压力翻倍。

基于以上行业痛点， FastPrint Agent 打印中间件：业务系统只需输出标准JSON报文，中间件自动生成FastReport报表数据集，无需手动绑定数据源；同时原生支持HTTP同步 + MQTT异步双通信协议，一套程序、一套JSON、一套报表模板，全覆盖内网本地、云端SaaS、工业物联网、连锁门店所有打印场景。

一、整体架构流程图（多终端+云端MQTT+多打印节点）

适配云端远程打印完整业务链路：多移动端下发打印指令 → 云端MQTT消息服务器 → 多台现场电脑打印服务 → 多台物理打印机，全链路异步稳定传输。

链路优势：现场打印服务主动长连云端MQTT，无需公网IP、无需端口映射、无需暴露内网端口，网络更安全；支持断线自动重连、离线任务缓存，车间/门店网络波动也不会丢打印单据。

二、核心亮点：JSON自动转FastReport数据集（项目独有核心能力）

这也是本项目区别于市面上所有打印工具的最大优势：零代码数据源绑定，全自动解析JSON生成报表数据集。

业务系统无需编写任何报表绑定代码，无需对接数据库，只需组装业务JSON报文，中间件即可自动解析JSON普通对象、嵌套明细数组，直接生成FastReport可直接使用的完整数据集。

打开FastReport设计器，所有业务字段、明细表格字段全部自动就绪，直接拖拽即可完成报表排版，全程无需开发介入数据绑定。

核心免除开发工作

• ❌ 无需手写字段映射代码

• ❌ 无需配置数据库数据源

• ❌ 无需手动处理数据类型转换

• ❌ 无需编写明细循环遍历逻辑

标准JSON入参示例

{     "printTemp": "SalesOrder",     "printer": "",     "printCn": 1,     "printData": {         "title": "销售订单",         "orderNo": "SO20240520001",         "customer": "张三",         "items": [             {                 "product": "笔记本电脑",                 "quantity": 1,                 "price": 5999             },             {                 "product": "鼠标",                 "quantity": 2,                 "price": 99             }         ]     } }

自动解析规则

三、双协议并行：HTTP / MQTT 无优劣之分，按需适配业务场景

本项目双协议完全并行，共用同一套JSON报文、同一套报表模板，切换通信方式无需改动一行业务代码。

3.1 HTTP 同步调用（内网本地场景首选）

核心特点

• 短连接同步通信，请求发送后即时返回打印结果

• 零额外中间件依赖，任意开发语言均可直接POST调用

• 支持Postman等接口工具直接调试，本地对接效率极高

适用业务场景

• 企业内网ERP、OA、进销存、财务系统本地单据打印

• 工厂同局域网工位机、车间本地报表打印

• 需要实时同步获取打印成败状态的内网业务系统

3.2 MQTT 异步长连接（云端/分布式/物联网首选）

核心特点

• 客户端主动发起长连接，无需公网IP、无需端口映射、不暴露内网端口，内网更安全

• 原生支持断线自动重连、离线消息缓存，网络恢复后自动补发打印任务，杜绝丢单

• 异步消息解耦，支持海量终端统一管理，适配一对多批量下发打印任务

• 支持全局任务ID溯源，异步主题回执，全链路追踪打印状态

适用业务场景

• 云端SaaS系统跨城市下发打印任务

• 连锁餐饮、商超、物流全国多网点远程打单

• 工业工控机、物联网边缘无固定IP设备打印

• 阿里云、腾讯云等云原生系统跨网段远程打印

3.3 双协议直观对比表

对比项

HTTP 同步打印

MQTT 异步打印

四、接口调用快速上手

4.1 部署步骤

4.2 HTTP接口调用示例

• 请求方式：POST

• 请求头：Content-Type: application/json

• 打印接口地址：http://127.0.0.1:9798/api/print-report

// HTTP入参和上方通用JSON完全一致，直接调用即可

4.3 MQTT接口调用示例

MQTT复用原有业务JSON，额外增加3个专属管控参数，实现动作指定、任务溯源、异步回执

{     "printTemp": "SalesOrder",     "printer": "",     "printCn": 1,     "printApi": "show-report",     "printTaskId": "1234567",     "responseTopic": "print/receive/1234",     "printData": {         "title": "销售订单",         "orderNo": "SO20240520001",         "customer": "张三",         "items": [             {                 "product": "笔记本电脑",                 "quantity": 1,                 "price": 5999             },             {                 "product": "鼠标",                 "quantity": 2,                 "price": 99             }         ]     } }

MQTT专属参数说明

• printApi：指定执行动作，支持print-report打印 / show-report预览 / export-pdf导出PDF

• printTaskId：自定义唯一任务ID，用于全链路日志溯源、异常排查

• responseTopic：回执主题，打印完成后自动推送执行结果

MQTT异步回执报文

{     "state": "success",     "code": 200,     "printTaskId": "1234567" }

五、项目全功能一览

✅ 核心报表能力

• JSON全自动解析，一键生成FastReport主表+明细数据集

• 零代码拖拽设计报表，支持条码、二维码、金额大写自动换算

• 三大输出能力：物理打印、在线预览、PDF文件导出

✅ 通信与部署能力

• HTTP同步 + MQTT异步双协议无缝切换

• Windows系统服务7×24h无人值守运行

• 可视化客户端，支持参数配置、在线调试、日志查询

✅ 内置调试工具箱

• JSON格式化、报文压缩、合法性校验

• 图片 ↔ Base64双向转换，适配电子签章打印

• 全量打印日志留存，双击日志一键回填请求参数

• 一键唤起报表设计器，自动绑定当前JSON测试数据

六、总结

FastPrint Agent 核心价值一句话概括：

业务系统只负责输出JSON，所有报表渲染、打印调度、网络通信全部交给中间件。

不用再重复开发报表数据源、不用维护内网+云端两套打印逻辑：

• 内网本地项目 → 直接用HTTP，简单高效、实时返回结果

• 云端远程/分布式项目 → 直接用MQTT，免端口映射、网络更稳、安全无暴露

一套中间件，搞定企业所有打印场景，大幅降低报表开发与运维成本。

项目地址：  GitHub – mingjiesoft/FastPrintAgent: FastPrint Agent – 轻量级企业打印服务中间件。支持HTTP同步 + MQTT异步双协议，解决跨语言本地及分布式远程打印难题，基于FastReport引擎，提供可视化无代码模板设计，适配内网本地、工控物联网、云端跨地域全场景打印。 · GitHub

Gitee地址：https://gitee.com/mingjiesoft/FastPrintAgenthttps://gitee.com/mingjiesoft/FastPrintAgent