商店健康
商店健康在 WCPOS v1.10.0 中引入。它取代了原来独立的日志屏幕,并新增了对同步状况、本地数据覆盖情况和服务器负载的实时可见性。
商店健康 是 POS 的仪表板,展示您的设备与 WooCommerce 商店之间发生的一切。请从导航抽屉(心跳图标)中打开它。它包含三个选项卡:性能、数据库 和 日志。
性能
性能选项卡回答的问题是“POS 给我的服务器带来了多少开销,同步是否健康?”
- 状态行——
✓ 正常或⚠ 需要关注,依据引擎的当前状态判断(已经恢复的短暂故障不会连续一天向您报警)。 - 实测活动——过去 24 小时内发出的请求数和典型响应时间,是本收银台的实际测量值,而非估算值。传输数据量是一个下限,因为未声明大小的响应计为零。
- 运行状况条——过去 24 小时中每小时一格。绿色表示该小时内的请求均无错误完成;琥珀色表示至少有一个请求失败(哪怕只有一个——没有阈值);空白表示应用当时未运行。
- 下次检查倒计时——距离下一次变更检查还有多久。在空闲的收银台上,它显示的时间可能合理地长于所配置的间隔,因为检查带有抖动,并且在空闲 10 分钟后会放慢。安静的收银台上倒计时较长是正常现象,并不代表同步停滞。
同步预设
三张预设卡片通过两个调节项设定本设备的同步积极程度——POS 检查变更的频率,以及每次请求获取的记录数:
| 预设 | 检查间隔 | 每次请求的记录数 |
|---|---|---|
| 节能 | 5 分钟 | 25 |
| 均衡(默认) | 60 秒 | 50 |
| 实时 | 10 秒 | 75 |
共享主机或经济型主机请选择 节能;当多台收银台需要快速看到彼此的更改且服务器负担得起时,请选择 实时。自定义 滑块会开放完整范围(5 秒–5 分钟,10–100 条记录)。
有两点需要了解:
- 设置按设备生效。 调整一台收银台不会影响其他任何设备——您想调整的每台收银台都需要重复该更改。
- 调节项旁显示的 约 N 次请求/天 是根据所配置间隔推导出的名义检查频率,既不是上限也不是预测值。抖动可能使实际数量上下浮动;无变更的
304开销很低,但仍计为一次请求。空闲衰减只会降低快于其 60 秒下限的预设的请求量,因此不会让均衡预设变得更慢。
更改立即生效,无需重启。有关这些数字背后的工程原理,请参见 同步性能。
数据库
数据库选项卡回答的问题是“这台设备上有什么,以及是否所有内容都已送达我的服务器?”
顶部有四个磁贴:可开始销售 里程碑、本设备上的记录数、已用存储空间,以及等待发送的更改数。
只要设备上有了第一件产品,它就会翻转为已达成。离线并不会阻止它——设备上已有产品的收银台就可以离线销售。这正是本地优先 POS 的意义所在。
覆盖表
每个同步的集合都有一行:设备上、服务器上 以及一根覆盖率条。这些数字遵循严格的诚实原则——服务器上 的总数始终是服务器真实上报的数字,绝不是猜测:
- 正在检查…——POS 还没有获得最新的服务器总数。如果某一行保持这个状态超过约 15 分钟,说明该集合的 REST 路由可能出现故障;请查看 日志。
- 覆盖率条不满通常是正常的。 客户会在空闲时间逐步下载,分类和优惠券在首次打开时下载,而 订单 条是相对于您的整个订单历史来衡量的,而收银台有意只保留未结和最近的订单——因此在完全健康的收银台上,订单也会显示为部分覆盖。
- 在执行“清除并重新下载”之后,计数为空或偏低是设计使然的结果,而不是同步停滞——按需下载的集合会在使用过程中重新填充,每一行的说明文字都会告诉您该集合是如何重新填充的。
从未送达服务器的更改
如果您的服务器永久性地拒绝了某项更改(例如,某笔销售创建时站点认为该请求无效而拒绝了它),POS 不会 无声地永远重试,也不会把它藏起来。该更改会被搁置并在此列出,同时附带服务器给出的原因、发生时间以及两个操作:
- 重新发送——根据记录 当前 的状态重新构建请求并再次排队。如果同一字段再次被拒绝,尝试次数会明显增加,而不会假装成功。
- 放弃——丢弃该更改。确认对话框会准确告诉您放弃对该记录意味着什么(包括当该记录只存在于本设备上时,放弃就等于删除它)。
恢复始终是一次刻意且可见的操作——这里没有任何自动行为。
清除并重新下载
每个集合行都提供 清除并重新下载,它会移除该集合的本地副本并重新获取。确认框会说明将移除多少条记录、大约多少存储空间,以及哪些内容会安全地留在服务器上。请优先使用它,而不是清除全部本地数据——它是有针对性的,而且不会让您退出登录。清除所有本地数据 仍然是彻底的重置手段。
日志
日志选项卡是本设备上同步活动的流水账:每行包含 时间、级别、事件、时长、状态,保留 30 天。
- 预设筛选器——全部 / 操作 / 错误 / 同步,另有一个 详细诊断 开关,可捕获 24 小时的额外细节,然后自动关闭。
- 行详情——错误和警告可展开,显示通俗易懂的原因、一行数据安全说明、建议的下一步操作,以及指向 错误代码 的帮助链接。每个详情视图都带有可复制的事件代码——联系支持团队时请附上它。
- 日志条目在显示时会被翻译,因此几个月前写入的一行会以收银台今天所用的语言呈现;事件代码才是稳定的标识符。
日志选项卡仅根据日志条目推导其卡住记录的计数;数据库选项卡还会计入被搁置的、遭拒绝的更改。当两者不一致时,以数据库选项卡为准,它才是判断哪些内容尚未送达服务器的权威。