写这篇避坑指南之前我其实已经帮朋友收拾过好几回烂摊子了。他们接手的项目几乎都是同一个症状UniApp 写的蓝牙打印功能在开发者工具里调试一切正常一打包到手机上就“原形毕露”——要么连不上打印机要么打印出来满纸乱码最离谱的一次是打印到一半卡住重启打印机才好。后来我仔细看了一圈代码问题基本都出在三个地方蓝牙连接的时序没处理好、指令集张冠李戴、再加上中文编码的 GBK/UTF-8 转换直接没做。这三个坑任何一个踩中都能让你在客户现场急得满头大汗。先说清楚这篇博文讲什么基于 UniApp 这套跨端框架去调用热敏打印机包含标签机和票据机重点拆解 TSPL、CPCL、ESC/POS 三种常见指令的格式与使用场景并给出可以直接抄作业的蓝牙通信封装代码。适合谁看如果你在用 uni-app 开发小程序或者 App并且被打印机折磨过这篇文章至少能帮你少加班一星期。如果你还没开始做那更要看因为方案选型阶段走错一步后面全是在给自己挖坑。1. 整体设计思路与方案选型1.1 先搞清楚你要用哪一种打印机指令热敏打印机的指令集市面上一搜一大把但说到底就三大流派TSPL、CPCL 和 ESC/POS。很多人一开始根本不在乎这个觉得反正都是“发文字过去打印”。等你真买了机器、连上蓝牙、把代码怼上去才发现完全不是那么回事。TSPL 指令主要用于标签打印机典型品牌是 TSC、立象、斑马的部分机型。它的特点是指令里带坐标定位、页面尺寸、间隙补偿打印标签纸、快递面单、固定资产贴纸这类场景非常合适。TSPL 的单位是打印点dot需要配合打印机分辨率如 203dpi来计算物理尺寸。CPCL 指令常见于便携式票据打印机比如佳博、汉印、芯烨的一些手持设备。它比 ESC/POS 更“现代化”一点指令结构清晰坐标体系好理解支持字体放大、条码、二维码。很多 PDA 上的打印 SDK 底层就是 CPCL。ESC/POS 指令这是老牌标准爱普生定义的那套几乎所有桌面式小票打印机和商超收银打印机都在用。指令短小、兼容性极强核心就那几个初始化、打印文本、切纸、走纸。这个分类为什么重要因为你选错指令集打印机要么完全没反应要么吐出来一张纯乱码纸。比如你买的是标签机却拿 ESC/POS 指令去喂它大概率输出不可预测的行为。反过来拿 TSPL 打小票也会因为缺少纸张定位逻辑而打偏。提示有些打印机同时支持多套指令比如部分佳博机器可以通过拨码开关切换 CPCL 和 ESC/POS有的标签机支持 TSPL 和 ESC/POS 双模式。购买前一定要确认你手里的机器默认开启哪套协议以及是否需要拨码或者发指令切换。1.2 为什么在 UniApp 里做蓝牙打印这么折腾UniApp 的优势是“一套代码跑多端”但劣势也明显它把所有平台的差异都藏在框架层一旦业务涉及底层硬件通信坑就出来了。打印这个事情牵扯到蓝牙 BLE、二进制字节流、厂商私有协议每一环都是 UniApp 的能力短板。具体来说UniApp 里做打印机连接有这几条路走 BLE 直连用 uni 提供的蓝牙 API自己去实现对打印机的发现、连接、服务发现、特征值写入。这种方式兼容性最广大部分便携式和部分桌面式打印机都支持 BLE坏处是很多低端打印机对同时连接的设备数有限制而且 Android 端和 iOS 端的表现差异很大。接厂商原生插件很多打印机厂商提供 uni-app 原生插件比如佳博、汉印、芯烨都出过官方或第三方的插件。好处是底层指令封装好了稳定性有保障坏处是插件更新不及时、收费或者只适配特定机型一旦需要换品牌就得重写。走云端打印打印机连 Wi-Fiapp 通过 HTTP 接口把打印内容推给打印机厂商的云平台打印机再从云端拉取。这种方式在局域网广域网都能用适合固定场景比如餐厅后厨、门店小票机。我见过很多项目第一步就掉坑——在微信小程序里用 BLE 直连做打印。微信小程序的蓝牙 API 本身是能用的但 Android 和 iOS 的底层行为不同尤其是 iOS 的蓝牙权限弹窗、特征值写入时机和 Android 差得比较远。你在开发者工具里用的是模拟器的蓝牙跟真机更是两回事。所以方案选型阶段的核心结论是如果项目时间紧、打印机型号固定优先找厂商的 UniApp 插件别自己硬撸指令如果打印机型号不固定比如对外卖工具或者通用型 App那就老老实实把 BLE 那套封装写扎实。1.3 方案选型的核心判断标准我的判断标准已经有一句话总结了稳定性第一开发效率第二。打印这种功能用户对失败零容忍。你做一个登录页面失败 1% 能接受打印一张面单失败一次可能就是补发成本客户体验直接崩。所以选型的时候顺着下面几个维度去决策评估维度BLE 直连厂商插件云端打印打印机兼容范围广但指令要自己适配窄限定某个品牌系列取决于厂商云端策略开发成本高需要处理指令和协议低文档齐全的话中需要对接 HTTP 接口离线可用是是否必须联网二次维护自己扛依赖厂商依赖厂商典型场景通用型扫码打印 App固定型号便携打印机门店固定位置小票打印具体到 UniApp 项目我的建议是优先方案 2厂商插件因为打印指令的坑实在太多了厂商插件能帮你挡掉大半次选方案 1BLE 直连前提是你有足够时间调试并且愿意维护一套自己的指令拼装模块。至于云端打印只适合打印机固定、网络稳定的场景便携移动场景别碰。2. 环境搭建与基础准备2.1 UniApp 蓝牙 API 全景UniApp 的蓝牙 API 基于 HTML5 的蓝牙模块封装和微信小程序的蓝牙接口很像基本上就是 openBluetoothAdapter、startBluetoothDevicesDiscovery、createBLEConnection、getBLEDeviceServices、getBLEDeviceCharacteristics、writeBLECharacteristicValue 这一套。大致的调用链路是这样openBluetoothAdapter初始化蓝牙适配器检查手机蓝牙是否开启。startBluetoothDevicesDiscovery onBluetoothDeviceFound开始搜索附近的 BLE 外设并监听搜索结果。createBLEConnection根据设备的 deviceId 发起连接。getBLEDeviceServices获取已连接设备的服务列表。getBLEDeviceCharacteristics从服务里找到对应的特征值characteristic需要确认它是可写的。writeBLECharacteristicValue往可写特征值里发送打印数据。这串逻辑本身不复杂真正复杂的是平台差异。举个例子Android 上搜索 BLE 设备从 Android 6.0 开始就要求应用必须有定位权限因为蓝牙扫描属于“粗略定位”范畴你没开权限搜索结果是零。iOS 上则要求 Info.plist 里有 NSBluetoothAlwaysUsageDescription否则直接崩溃。这些平台差异在 HBuilderX 的 manifest.json 里配置权限描述时容易被忽略。2.2 权限与配置的坑在项目的 manifest.json 里需要针对 App 平台做权限配置。以我的经验最常见的配置问题就是缺少隐私权限描述打包后一打开蓝牙功能就白屏或者闪退。Android 端建议在 manifest.json 的 app-plus 节点下配置以下权限android.permission.BLUETOOTHandroid.permission.BLUETOOTH_ADMINandroid.permission.ACCESS_FINE_LOCATION低版本 Android 必需的定位权限android.permission.ACCESS_COARSE_LOCATIONiOS 端需要在 app-plus 的 distribute 里配置隐私描述比如“App 需要使用蓝牙连接打印机以便实现票据打印功能”对应 NSBluetoothAlwaysUsageDescription。同时注意 iOS 13 之后系统的蓝牙权限分类更细必须用“每次询问”或“始终允许”否则系统弹窗都不出来。注意千万别只处理 App 端。如果你同时发布了微信小程序版本还要在小程序后台配置蓝牙相关权限说明否则审核时会被驳回。权限配好后可以在代码里做一次检测uni.openBluetoothAdapter({ success(res) { console.log(蓝牙初始化成功, res); }, fail(err) { console.error(蓝牙初始化失败, err); // 提示用户打开蓝牙或授权 } });如果这里失败后面所有操作都不用谈了。一个很实用的技巧是在 openBluetoothAdapter 失败时不要光弹 toast最好引导用户去系统设置里打开蓝牙和定位权限因为很多国产手机系统的权限设置和原生 Android 不完全一样。2.3 服务发现与特征值选择的实战要点连接打印机成功后下一步是遍历服务和特征值这一步问题最多。各家打印机的服务和特征值 UUID 不统一有的用标准 Bluetooth SIG 定义的 16 位 UUID有的用厂商私有 128 位 UUID甚至有些打印机广播的服务是隐藏的需要先发送特定指令才能被读到。通用做法是连上后遍历所有服务再遍历每个服务下的所有特征值找到属性为 write 或者 writeWithoutResponse 的那个特征值把它存下来之后所有数据都往这里写。uni.getBLEDeviceServices({ deviceId, success(res) { const services res.services; services.forEach((service) { uni.getBLEDeviceCharacteristics({ deviceId, serviceId: service.uuid, success(charsRes) { charsRes.characteristics.forEach((char) { // 找到可写的特征值 if (char.properties.write || char.properties.writeNoResponse) { writeCharUUID char.uuid; console.log(找到可写特征值, char); } }); } }); }); } });这里有个细节很多打印机的 write 特征值支持 writeWithoutResponse无应答写入这种模式下写入速度快很多也不容易出现“等待确认导致超时”的问题。从我的实测经验看只要打印机支持优先用 writeWithoutResponse一次性把一包数据拆成多段连续写入打印速度明显提升。但注意有些低端蓝牙模块在两段写入之间需要间隔否则会丢包这个后面细说。3. TSPL/CPCL/ESC 指令详解与实战3.1 TSPL 指令标签打印的硬核选手TSPLTSPL/TSPL2是 TSC 标签打印机使用的一种指令语言。它最直观的特点就是采用“先布局再打印”的方式你先把页面尺寸、标签间隙、要打印的文字、条码、二维码都规划好最后发一条 PRINT 指令打印机才开始走纸输出。我封装 TSPL 打印时最常用到的指令有这么几个SIZE设定标签尺寸比如SIZE 60 mm,40 mm表示宽 60 毫米高 40 毫米。有的机器也支持用 dot 单位比如SIZE 203,203。GAP设置标签间隙单位通常是 mm比如GAP 2 mm。如果你的标签是连续纸没有间隙需要写成GAP 0。CLS清除图像缓冲区相当于重置画布每次打印前必发。TEXT打印文本格式是TEXT x,y,font,rotation,multiplication_x,multiplication_y,content。其中 x、y 是起点坐标单位 dotfont 是字体类型rotation 是旋转角度multiplication 是放大倍数。BARCODE打印一维条码格式是BARCODE x,y,codeType,height,readable,rotation,content。QRCODE打印二维码格式是QRCODE x,y,level,cellWidth,mode,rotation,content。PRINT执行打印格式是PRINT copies, copies_gap比如PRINT 1,1表示打印 1 张。下面是一段我常用的 TSPL 拼接代码function buildTSPL(options) { const { width 60, height 40, gap 2, text , qrContent } options; let cmd ; cmd SIZE ${width} mm,${height} mm\r\n; cmd GAP ${gap} mm\r\n; cmd CLS\r\n; if (text) { cmd TEXT 5,5,TSS24.BF2,0,1,1,${text}\r\n; } if (qrContent) { cmd QRCODE 5,40,M,2,A,0,${qrContent}\r\n; } cmd PRINT 1,1\r\n; return cmd; }这里有个坑需要提醒TEXT 和 QRCODE 的坐标原点是在标签左上角单位是“点”不是毫米。203dpi 的打印机1 毫米大约等于 8 个点300dpi 的打印机1 毫米约等于 12 个点。所以你要做精确定位最稳的方式是先打一张测试页数清楚打印出来的实际位置偏差再反过来调坐标。3.2 CPCL 指令便携机的灵活派系CPCLControl Printer Command Language最初是 Zebra 为便携打印机设计的后来被很多国产便携打印机采用。它的结构是“初始化 定义页面 画图形 输出”。CPCL 的核心指令结构! 0 200 200 200 1 PAGE WIDTH 384 TEXT 4 0 0 0 Hello FORM PRINT这段指令的含义是! 0 200 200 200 1是初始化命令其中 200 是打印机的横向分辨率、纵向分辨率可以理解成 DPI后面的 200 是标签宽度单位 dot1 是标签高度单位是倍数比较特殊。PAGE WIDTH定义页面宽度TEXT x y fontScale rotation content是打印文本FORM表示页面定义结束PRINT执行打印。CPCL 对坐标的处理比 TSPL 更“模块化”它还支持放大文本function buildCPCL(text, qr) { let cmd ; cmd ! 0 200 200 200 1\r\n; cmd CENTER\r\n; cmd TEXT 4 0 0 0 热敏打印测试\r\n; if (qr) { cmd BARCODE 128 1 50 0 0 1234567890\r\n; } cmd FORM\r\n; cmd PRINT\r\n; return cmd; }这里比较实用的是CENTER指令它可以让文本自动居中省去手动计算宽度的麻烦。另外 CPCL 的字体大小用数字 0-5 控制数字越大字体越大这一点比 ESC/POS 直观适合快速开发。提示CPCL 指令本身没有中文编码支持它依赖数据和打印机内部的字库映射。所以这里中文乱码的概率非常高解决方案在后面编码章节一起讲。3.3 ESC 指令小票打印的通用语言ESC/POS 是“老大哥”级别的指令集几乎所有桌面式小票打印机都认它。它的核心思路是“流式”你不需要预先定义页面直接按顺序往打印机塞数据和指令打印机边收边打。ESC/POS 最常用的序列ESC 0x1B 0x40初始化打印机清除缓冲区恢复默认设置。LF0x0A换行。ESC d n0x1B 0x64 n走纸 n 行。GS V n0x1D 0x56 n切纸n 为 0 或 1。GS v 00x1D 0x76 0x30查询打印机状态。拼装字节流时把中文字符串转成 GBK 字节然后加上指令头尾function buildESC(text) { // 初始化 const init new Uint8Array([0x1B, 0x40]); // 文本内容转字节 const content textToGBKBytes(text); // 换行和走纸 const feed new Uint8Array([0x1B, 0x64, 0x03]); // 切纸 const cut new Uint8Array([0x1D, 0x56, 0x01]); // 拼接所有部分 const totalLength init.length content.length feed.length cut.length; const buffer new Uint8Array(totalLength); buffer.set(init, 0); buffer.set(content, init.length); buffer.set(feed, init.length content.length); buffer.set(cut, init.length content.length feed.length); return buffer.buffer; }这个函数看起来简单但 header 部分初始化指令特别容易漏。如果打印机的上一份任务没有正确结束比如卡纸、断电、断线重连缓冲区内可能残留旧指令不先发ESC 清一下轻则排版错乱重则直接打出一堆异常字符。所以我的习惯是每次建立连接成功后的第一件事先发ESC 。3.4 中文编码是最大的坑终于说到这篇文章里我认为最重要的一个点中文编码。热敏打印机的字库方案千差万别但绝大多数收据打印机和标签打印机默认使用 GBK/GB2312 编码而 UniApp 里的 JavaScript 字符串是 UTF-8 编码。你直接在代码里写writeBLECharacteristicValue({ data: 你好.toString() })实际上传过去的字节是 UTF-8 的“你好”打印机根本不认打印出来就是乱码、问号或者干脆空白。解决方法有几种后端转码把打印内容通过 HTTP 接口传给后端后端用 Node.js 或 Java 的 iconv 转成 GBK返回 ArrayBuffer 给前端。这种方式最稳妥适合项目原本就有后端的情况。前端内置编码映射表在 uni-app 里写一个 GBK 映射表把中文字符映射到 GBK 编码然后用字节数组拼接。这种方案不依赖网络但工程量不小遇到生僻字容易漏码。使用支持 UTF-8 的打印机现在一些新型号适配了 UTF-8 编码比如某些汉印、佳博的新固件。但老机器不支持兼容性仍然是大问题。我的实际项目里采用的是方案 2 的轻量版把常用字符集聊天记录、商品名称、备注信息这类高频词做成映射表剩下的兜底逻辑是“如果有字不在表里就在 App 端弹出提示让用户改文案”。这是不得已的选择如果你的打印机型号固定建议花时间做一个完整的 GBK 编码转换工具类一劳永逸。注意UniApp 的 H5 端和微信小程序端不支持 Node.js 的 Buffer所以不要试图在前端直接调用 iconv-lite。你要么用原生日志打印插件要么用映射表方案。这是我绕了大半圈才搞明白的。4. 实操流程与代码拆解4.1 完整流程扫描、连接、发送、销毁下面给出一段我在项目中使用的完整蓝牙打印流程代码已经去掉业务逻辑只保留核心的“握手”部分。// 1. 初始化蓝牙 function initBluetooth() { return new Promise((resolve, reject) { uni.openBluetoothAdapter({ success: resolve, fail: (err) reject(new Error(蓝牙初始化失败 JSON.stringify(err))) }); }); } // 2. 搜索设备 function startDiscovery() { return new Promise((resolve, reject) { uni.startBluetoothDevicesDiscovery({ allowDuplicatesKey: false, success: resolve, fail: reject }); // 监听设备 uni.onBluetoothDeviceFound((res) { const devices res.devices || []; // 过滤掉信号太弱的设备 const validDevices devices.filter(d d.RSSI -70); // 这里根据实际打印机的名称前缀做筛选 const printer validDevices.find(d d.name d.name.includes(Printer)); if (printer) { uni.stopBluetoothDevicesDiscovery({}); resolve(printer); } }); }); } // 3. 连接设备 function connectDevice(deviceId) { return new Promise((resolve, reject) { uni.createBLEConnection({ deviceId, success: resolve, fail: reject }); }); } // 4. 订阅特征值通知有些打印机会回传状态必须订阅才能收到 function subscribeNotification(deviceId, serviceId, charId) { return new Promise((resolve, reject) { uni.notifyBLECharacteristicValueChange({ deviceId, serviceId, characteristicId: charId, state: true, success: resolve, fail: reject }); }); } // 5. 写入打印数据 async function writeDataToPrinter(deviceId, serviceId, charId, dataBuffer) { const chunkSize 20; const totalChunks Math.ceil(dataBuffer.byteLength / chunkSize); for (let i 0; i totalChunks; i) { const start i * chunkSize; const end Math.min(start chunkSize, dataBuffer.byteLength); const chunk dataBuffer.slice(start, end); await new Promise((resolve, reject) { uni.writeBLECharacteristicValue({ deviceId, serviceId, characteristicId: charId, value: chunk, success: resolve, fail: reject }); }); // 两段写入之间稍作延时避免丢包 if (i totalChunks - 1) { await sleep(50); } } } function sleep(ms) { return new Promise(resolve setTimeout(resolve, ms)); }这段代码体现了完整的“蓝牙五步走”初始化、搜索、连接、订阅、写入。每一步都用了 Promise 封装方便在 async/await 里串起来。实际使用时我会再加一个超时保护比如每步超过 8 秒就报错避免用户等待无响应。4.2 打印成功率的关键分包与重试BLE 写入的“20 字节限制”是新手最容易撞上的问题。BLE 协议里默认 MTU最大传输单元一般是 23 字节扣掉 3 字节的协议头留给应用层的可用空间就是 20 字节。如果一次写入超过 20 字节iOS 端大概率直接报错参数错误或写入失败Android 端表现不太一样有些手机会自动分包发送但自动分包容易导致打印机接收不完整。稳妥的做法是代码里强制分包每次只写 20 字节发完一段等 20~50 毫秒再发下一段。上面代码里用的就是这种策略。关于延时不能太短否则打印机蓝牙模块缓冲池被塞满后直接丢包也不能太长否则打印速度慢得让人怀疑人生。我测了十几台主流打印机50ms 间隔比较折中。重试机制的参考策略写入失败时重试 3 次每次间隔 100ms。如果连续 3 次失败把失败的那段数据和当前序号缓存下来打印日志同时提示用户“蓝牙连接不稳定请靠近打印机后重试”。打印任务结束后主动调用uni.closeBLEConnection断开连接。不要长期占用连接很多打印机的蓝牙模块只支持 1 个连接不断开会阻塞别的设备。注意不要在主流程里用同步阻塞的方式去等待打印机回包因为很多低端打印机的 notify 特征值并不可靠。正确的姿势是“发完即走”通过打印机的蜂鸣声或者实物出纸来判断是否成功而不是在代码里等通知。4.3 打印质量与排版校对清单打印功能做完之后验收阶段最重要的就是竖着耳朵听、瞪着眼睛看。我在现场调试时通常会按下面这个清单走一遍自检页打印很多打印机支持通过指令或长按按键打印自检页上面会显示当前 DPI、固件版本、默认编码。先打一张自检页确认你的打印机固件正常。内容超出边界打印机对图形的处理方式是“超出部分直接截断”不会自动换行。所以你要在代码里控制字符串长度。比如 58mm 宽的便携打印机一般一行能打印约 32 个英文字符或 16 个中文字取决于字号和缩放。边缘留白热敏打印机的有效打印区域比纸宽要小一些两边各留约 2mm 的不可打印区域。设计模板时要留出这个安全边距否则内容会被切边。标签位置校准如果你打印的是标签纸发现每次都偏一点检查 GAP 指令和标签间隙是否匹配。有些标签纸的间隙很小打印机可能把间隙误判为黑标需要在指令里调整灵敏度。打完以上流程你基本能把打印质量和排版问题定位到“代码问题”还是“耗材问题”再去针对性地调。5. 常见问题与排查技巧实录5.1 高频问题速查表现象可能原因解决方案搜不到打印机蓝牙未开启Android 未授权定位距离太远打印机处于连接状态打开蓝牙和定位权限把打印机靠近手机先断开旧连接连接失败打印机已连接其他设备BLE 连接数满重启打印机蓝牙关闭旧连接检查设备名是否对打印乱码中文编码错误指令集不匹配转换为 GBK 编码确认打印机支持的指令协议打印空白打印头未加热打印纸装反检查纸张方向重置打印头用自检页验证打印一半停止蓝牙信号不稳定发送速度太快导致丢包调整分包间隔到 50ms 以上靠近打印机重试切纸不生效打印机不支持切纸功能切纸指令错误查阅机型规格尝试 GS V 0 和 GS V 1第一次打印必失败连接后未初始化打印机连接成功后先发 ESC / CLS 指令这张表是我在项目上线后被真实用户吐槽之后才慢慢总结出来的。每一行都对应着一次半夜帮客户远程调试的“血泪经验”建议你直接收藏。5.2 实战中的独家经验与隐藏雷区下面这些经验是我在大量设备上踩出来的官方文档基本不会写。第一很多打印机连接成功后第一笔写入会失败。原因很可能是蓝牙协议栈还没有完全就绪。解决办法是连接成功后先发一个无害的初始化指令比如 ESC 或者 CLS等 200ms 再发真实数据。这个“预热”动作看起来多此一举却能显著降低首单失败率。第二过滤蓝牙设备时不要只看设备名。市面上很多打印机用的是通用蓝牙模块设备名可能叫“BLE-PRINTER”“SPP”甚至一串乱码。建议在搜索时同时记录广播数据的 service UUID因为打印机厂商一般会在广播里暴露自己的服务 UUID拿这个做筛选项比设备名可靠得多。第三Android 端扫描回调里可能会同一个设备重复出现多次。uni.onBluetoothDeviceFound 会持续回调你需要自己维护一个设备列表重复出现的设备只需要更新 RSSI 即可否则会导致 UI 闪烁并且可能重复发起连接。第四关于 MTU 协商。部分 Android 手机默认 MTU 只有 23 字节但打印机可能支持更大的 MTU比如 247 字节。UniApp 没有提供直接协商 MTU 的 API所以不建议追求“一次写大块数据”老老实实 20 字节分包反而最兼容。第五打印机的“状态回传”一定要用 notify 订阅但不要指望它。我遇到过几台打印机虽然设置了 notify 特征值但实际上从不主动上报状态或者只在出错时才上报。所以不要把业务逻辑建立在“收到打印机成功回执”上只要 write 调用不报错就认为指令已经发到打印机缓冲区了。5.3 给“踩坑者”的临场排查步骤如果你现在已经在客户现场或者项目调试中打印机怎么都不按预期工作不要慌按下面顺序排查先确认打印机绝对没问题用打印机自带的演示模式打印一张自检页。打不出来说明打印机硬件或者纸卷有问题代码先放一边。再确认指令集匹配拿厂商提供的调试工具比如 TSC 的 TSPL 调试软件、佳博的打印助手直接发一条最基础的指令。如果调试工具能打印你的代码却不行问题在协议封装而不是打印机。检查蓝牙连接链路在连接成功后写一个最简单的 1 字节数据试一下能不能成功写入。连这个都失败说明蓝牙连接本身有问题检查设备占用、权限、距离。用日志打印每次写入的字节内容打印指令本来就是一串十六进制字节流你把每次写入的数据转成 hex 字符串输出到日志一眼就能看出是不是初始化和内容拼接出了问题。最后才怀疑编码确认以上都没问题再排查 GBK/UTF-8 转换因为编码问题通常表现为“能打印但内容乱码”而不是“打印完全无响应”。这个顺序能帮你把 80% 的问题定位到具体环节避免瞎试浪费半天时间。写到这里我回忆了一下自己第一次把 UniApp 蓝牙打印功能跑通时的场景一台老旧的热敏标签机、一台 Android 测试机还有满屏的调试日志。折腾了两天最后发现只是漏了 GAP 指令标签纸一直按默认间隙走纸导致每张标签都偏了几毫米。那一刻我才真正意识到做打印机对接这个事百分之八十的精力都花在“细节”上而协议本身反而不是最大的障碍。如果你正在被同样的问题折磨记住先确认打印机型号和指令集再搭蓝牙通信框架最后处理编码每一步都别跳。希望这篇避坑指南能帮你少走这些弯路。
