打印机连接常见问题：连不上、打不出、打不对怎么办

把实际会撞到的报错一次讲清：No route to host、PRINTER_OFFLINE、打印机 IP 变了、同一台打印机在系统里出现好几遍、Mac 提示 Out of ink、更新卡在「Downloading update…」、打出来空白或乱码——并从能把所有问题一分为二的一步开始：Device Hub 的 Test Print。

标签打不出来时，问题只会出在三个地方之一：电脑到打印机这段路、打印机本体、或者系统把任务发给了错误的打印机条目。有一招能先把范围砍一半：打开工作站上的 Device Hub，在 Connected Devices（已连接设备）里找到那台打印机，点它那一行的 Test Print（测试打印）。测试标签能出来，说明路和打印机都没问题——毛病在应用里选错了打印机（看最后一节）。Test Print 报错时，报错的关键词就对应下面哪一节。报错原话请留好：像「No route to host」这样的关键词，是您自己——和客服——最快对上号的线索。

1. 报错 No route to host：电脑根本够不着打印机#

您会看到什么：在 Device Hub 点 Test Print，弹出红字，类似「Test print failed: [PRINTER_OFFLINE] 连接 10.10.200.138:9100 失败：No route to host」。No route to host 就是字面意思：您的电脑没有一条网络通路能走到打印机的地址。打印机本身没坏——它有自己的地址（网络打印机的屏幕上会显示，比如「ETH 10.10.200.138」）——是电脑和打印机不在同一个网络里。最常见的原因：打印机的网线插的路由器/交换机，和电脑用的不是同一个；或者电脑连的是访客 Wi-Fi，访客网络一般禁止访问局域网里的设备。

1. 先看打印机屏幕上的 IP（Ready 界面会显示）。再看电脑自己的 IP：Mac 在「系统设置 → Wi-Fi → 已连接网络的详情」里，Windows 在「设置 → 网络和 Internet → 属性」里。
2. 对比两个 IP 的前三段。对不上（比如电脑 192.168.1.20、打印机 10.10.200.138）就是不在同一个网——问题全在这里。前三段相同（比如都是 10.10.200.x）说明同网，原因要往别处找。
3. 把打印机的网线插到电脑正在用的同一个路由器/交换机上；电脑连主 Wi-Fi，不要连访客 Wi-Fi。插好后打印机屏幕上的 IP 会变成和电脑同网段的新地址。
4. 如果打印机 IP 变了，Device Hub 里存的还是旧地址：把那条网络打印机删掉、按新地址重新添加一遍（Setup Wizard 会一步步带着走），再点 Test Print 复验。

2. 打印机 IP 变了：昨天能打，今天连不上#

大多数网络是自动分配地址的（这叫 DHCP）。打印机重启或断电回来后，可能拿到一个新地址，而 Device Hub 还在找旧的那个——症状和第 1 条一样，但您什么都没动过。对比一下打印机屏幕上的地址和 Device Hub 里存的地址，不一样就是它了。想一劳永逸：在路由器里给这台打印机做地址保留（把地址绑给它），或者在打印机自己的网络设置里设一个固定（静态）IP；然后在 Device Hub 里把那条记录更新成这个地址，以后就不会再漂了。

3. 显示 PRINTER_OFFLINE / 离线：先看打印机本体#

任务报 PRINTER_OFFLINE 时，先别动电脑设置——走到打印机跟前看它的屏幕。多数「离线」其实是打印机在喊话：

• 缺标签纸或碳带——换上新卷（换卷后在打印机屏幕菜单里做一次 Calibration 校准，让它认清新纸的间隙）。
• 上盖没关严——把上盖往下压到两侧都卡住。
• 处于暂停（Pause）——不少打印机报错后或被按过键后会停在暂停状态；在屏幕或按键上把它恢复到 Ready。
• 网络打印机再顺手查网线：两头都插紧、交换机对应口的灯亮。处理好回 Device Hub 点 Test Print 确认恢复。

4. 同一台打印机在电脑里出现好几遍，还成了默认打印机#

您会看到什么：Mac 或 Windows 的打印机列表里，同一台打印机出现两三遍（名字后面带「 2」「 3」），其中一条还被设成了系统默认打印机——平时打个文档，都会跑到标签机上出一张小标签。成因是这台打印机以前被用不同方式重复添加过（按地址加一次、自动发现加一次、重装驱动又加一次）。重复条目不是摆设：应用会选到您没想用的那条，任务就像凭空消失。

1. 在系统打印机设置里把重复的几条删掉（Mac：系统设置 → 打印机与扫描仪；Windows：设置 → 蓝牙和设备 → 打印机和扫描仪）。删系统里的条目不影响 Device Hub：Hub 里那条网络打印机（显示为「Network printer 10.10.200.138 · 9100」）是直连打印机的，不经过系统列表。
2. 把系统默认打印机改回普通办公打印机，免得日常文档继续误打到标签机上。
3. 在 Device Hub 里确认这台打印机的归类：标签机应归在 Label Printer（标签打印机）下面，办公打印机归 Regular Printer。每行都有切换按钮（比如「Change to Label Printer」）——标签只能打到 Label Printer，打不到普通打印机上。

5. Mac 提示 Out of ink（没墨了）：是误报#

热敏和热转印标签打印机根本没有墨盒——靠加热打印头成像。macOS 读不懂这类打印机的状态，就会报「Out of ink」（没墨了），还给它标个红点，其实一切正常。不用管它：以打印机自己屏幕显示为准。真缺标签纸或碳带时，打印机屏幕会用明白话直接写出来。

6. 打出来空白、乱码，或者尺寸不对#

任务送到打印机了，但打出来的不对。按这个顺序查四件事：

1. 选的条对不对：走 Device Hub 里的网络直连条（显示 IP 地址和 9100 端口的那条）——它把标签数据原样发给打印机。经过操作系统打印机驱动的条目，会在路上缩放或转码，标签就容易变小、错位，甚至打不出来。
2. 打印语言对不对：Docklify 的面单是 ZPL 打印机指令。打印机要工作在 ZPL 模式下（不少工业机同时会自己的语言比如 TSPL，并提供 ZPL 仿真——如果只设在原生语言上，ZPL 打出来就是白纸或一串原始文字）。需要时在打印机设置里切到 ZPL 仿真；打之前可以先在 Utilities → ZPL 查看器（/utilities/zpl-viewer）里预览这张 ZPL 应该长什么样，分清是数据问题还是打印机问题。
3. 尺寸对不对：模板里的标签尺寸要和打印机里装的纸一致——4×6 的面单模板装了 4×3 的纸，就会被切掉或压小。尺寸在生成标签的地方（标签模板）改，不在打印机上改。
4. 换纸卷后要校准：装了新卷后如果打印漂移、跳张、或停在两张之间，在打印机屏幕菜单里做一次 Calibration 校准——让它重新量一遍标签间隙。

7. Device Hub 云同步未就绪，或日志里刷满「拉取任务失败」#

您会看到什么：打印机明明是好的，标签却不再出来；Device Hub 窗口下方的 Runtime Log（运行日志）里反复出现「拉取任务失败」一类的报错，或者云同步一直到不了「就绪」。这背后其实是两种情况。常见的一种：工作站的网络短暂断过，Hub 记下一串报错，之后自己恢复了——但旧报错留在日志里，看上去像一直坏着。真正的故障是另一种：Hub 此刻确实连不上云端，或者配对丢了，网页应用的任务根本到不了这台电脑。区分方法就在日志里：每行都带时间戳。

1. 先看最新的几行。如果报错都是旧的（一小时前、昨晚），而最新几行显示同步完成（台账同步完成、云同步就绪），说明已经自己恢复了，不用处理。
2. 看 Hub 窗口里的配对状态。如果显示未配对，重新配一次：记下 Hub 上的 6 位配对码，在网页端输入——打印时弹出的配对框，或者 SaaS → Admin → Print Devices（打印设备页，Hub 配对就在那里管理）。
3. 重启 Hub：彻底退出 Device Hub 再重新打开。它启动时会重新注册、重新同步设备台账、重新连上云同步——然后在日志里确认最新几行是同步完成，再点一次 Test Print 复验。
4. 还是不行？先确认这台电脑能上网（随便打开一个网页）。网页能开、但日志还在不断冒新报错，就点 Hub 窗口里的 Copy Log 把日志发给客服，并说明大概从几点开始——剩下的时间戳会说话。

8. 更新卡在「Downloading update…」，进度条半天不动#

您会看到什么：Device Hub 提示有新版本，进度条在「Downloading update…」下面开始走，然后半天不动；窗口还可能写着有打印任务进行中、更新已推迟。其实什么都没卡住。Hub 有一条规矩：打印活动期间不装更新——哪怕只是一次 Test Print 也算打印。如果它在准备安装时检测到正在打印，就会悄悄取消这一次安装、把更新推迟（过一段时间再提醒，一般是一小时），旧版本里窗口还可能继续显示着「下载中」，看起来像卡死了。

1. 彻底退出 Device Hub 再重新打开——是退出应用本身（Mac 在它的菜单里选退出，Windows 在托盘图标上选退出），不是关个窗口。这样能清掉残留的「下载中 / 打印进行中」状态。
2. 重开后点 Update now（立即更新），让它一次走完：下载、安装、自动重启，版本号变了就是装好了。
3. 这几分钟里不要点 Test Print，也不要从打包台打标签——任何打印活动都会让安装器再次推迟。

9. Test Print 成功，但打包台点了打印没动静#

Test Print 成功，已经证明电脑到打印机这段路和打印机本体都没问题。所以在 Packing Station（SaaS → WMS → Packing Station）点了打印却没标签出来，任务多半是去了别的地方。在 Docklify 里，标签任务发给哪台打印机分两级看。第一级是本机 Device Hub 的本级默认：这台电脑的 Device Hub → Connected Devices 里被标为默认标签打印机的那台——它优先。只有本机 Hub 没设本级默认时，才轮到第二级仓库默认：SaaS → Admin → Print Devices 里为本仓库设的那台默认标签打印机。如果那台仓库默认打印机挂在另一台工作站的 Hub 上，任务会走云中继送过去，那台电脑的 Device Hub 必须正在运行，没开的话任务根本送不到。还有一种情况：两级都没设默认时，打印不会自动替您选一台，而是会弹出选机让您自己选；选的时候可以顺手把选中的那台设为本机的默认标签打印机。

1. 先查本机 Hub 的本级默认：打开打包台这台电脑上的 Device Hub → Connected Devices，看哪台打印机那一行带着默认标签打印机的标记。标错了、或者正确的那台根本没标，就在正确打印机那一行点「Set as default label printer（设为默认标签打印机）」。本级默认是第一顺位，所以先在这里改对，再去看别处。
2. 再查仓库默认：打开 SaaS → Admin → Print Devices，看哪台打印机挂着本仓库的默认标签打印机标记、状态是在线还是离线。标记指错了，就改到正确的那台上。记住：仓库默认只在本机 Hub 没有本级默认时才生效；如果标记的那台挂在另一台工作站的 Hub 上，任务是走云中继送过去的，那台电脑的 Hub 必须正在运行。
3. 如果正确的那台显示离线，去它所在的那台电脑上把 Device Hub 打开——那台电脑的 Hub 不运行，任何任务都到不了打印机。
4. 顺手在那台电脑的 Device Hub 里确认这台打印机的归类：必须在 Label Printer 下面，而不是 Regular Printer（用它那一行的「Change to Label Printer」按钮切换）。
5. 回打包台再打一次，并盯着那台打印机看。标签从那里出来了，就是设对了——之前那几次任务，只是老老实实送去了当时默认所指的地方。

10. 打包台的承运商面单、配对提示与承运商拒单#

订单指定了 UPS、FedEx 这类承运商时，打包台会向承运商买单，面单和普通面单一样直接从您的标签打印机出来。如果承运商回的是图片面单，面单会在浏览器新标签页打开，并自动弹出打印对话框——在那个对话框里打印即可。打包台的提示会如实区分这两种情况：只有真的送到打印机了才说「已打印」；走新标签页时会明说面单已在新标签页打开、需要您在那边打印。重印永远是同一张面单，不会再买一张新的。

如果这台电脑的 Device Hub 在运行、只是这个浏览器还没和它配对，面单不会再卡在配对提示上：只要仓库里有可用的云打印机，面单会自动送去那边照样打出来。只有在没有可用云打印机时，才需要您输入 6 位配对码。如果您没配对就关掉了配对框，打包台会明确提示这张面单还没打印——完成配对，或者准备好后在包裹上点「重印」即可。

承运商拒绝生成面单时，打包台现在会用大白话说清出了什么问题、下一步怎么办——比如检查订单地址、承运商账号、或您选的服务——而不是只给一句含糊的「出错了」。这次被拒的尝试还会以「面单受阻」记入「异常」：把原因修好后，在那里重新买单即可。承运商拒单时，打包台绝不会悄悄改打一张本地面单顶替。

11. 手机「我的打印机」里看不到打包台在用的打印机，或者同一台这里标离线、后台却是在线#

现象是这样：在手机上（手机站 → WMS → 更多 → 我的打印机）能看到的打印机，比仓库里实际在打的少很多；或者同一台打印机，这里标着离线，同事在 SaaS → Admin → Print Devices 里看却是在线。这两个都是显示口径的事，不是打印机坏了。「我的打印机」列的是：手机上当前选中的那个仓库的打印机，加上管理员还没分配到任何仓库的组织打印机——后面这组会单独成组、标著「还没分配仓库的打印机」。如果手机上选的仓库和您人所在的仓库不是同一个，列表跟的是手机选的仓，先把仓库选对。再有，「离线」在两个屏幕上都是同一个意思：系统超过两分钟没收到这台打印机所在 Device Hub 的消息了——那台电脑上的 Hub 没开、电脑睡了，或者掉网了。

1. 先看手机上当前选的仓库。「我的打印机」跟的是手机当前仓——切到您所在的仓库，再重新打开这个页面。
2. 先别急着下结论说打印机不见了，去「还没分配仓库的打印机」那一组里找找。那组里的打印机完全能用——打印本来就找得到它们（其中一台甚至可能就是组织默认）。您也可以在那里把某一台选成自己的个人默认。
3. 如果某台打印机应该长期归某个仓库，由管理员在 SaaS → Admin → Print Devices 里分配一次（那个页面有未分配筛选，顶部还数着有几台没分配）。分配完，它在各处都会进到那个仓库的组里。
4. 如果某台标着离线，去它连着的那台电脑上把 Device Hub 打开，再重新打开「我的打印机」——Hub 重新报到后，一两分钟内离线标记就会消失。管理员在 Print Devices 里看到的是同一套判断，两个屏幕不会各说各的。

本文用到的 Docklify 功能#

• 对任何已连接打印机做测试打印——Device Hub → Connected Devices（已连接设备）
• 添加网络打印机与首次设置向导——Device Hub → Setup Wizard
• 在标签打印机与普通打印机之间切换归类——Device Hub → Connected Devices → Change to Label / Regular Printer
• 仓库默认标签打印机、设备在线状态与 Hub 配对管理——SaaS → Admin → Print Devices；每台工作站优先用的 Hub 本级默认，在 Device Hub → Connected Devices 的打印机行上设置
• 运行日志与一键复制日志给客服——Device Hub → Runtime Log
• 打印前预览 ZPL 面单应有的样子——SaaS → Utilities → ZPL 查看器（/utilities/zpl-viewer）
• 打包台标签打印——SaaS → WMS → Packing Station