故障排查

本文档提供富掌柜收银系统常见故障的排查和解决方法。

系统无法启动

症状

• 点击应用图标无反应
• 启动后闪退
• 卡在启动界面

排查步骤

安卓版

1. 检查系统版本

   设置 → 关于手机 → 安卓版本
   要求：Android 7.0 及以上

2. 清理缓存

   设置 → 应用管理 → 富掌柜 → 存储 → 清除缓存

3. 重新安装

   1. 卸载当前版本
   2. 重启手机
   3. 重新下载安装

4. 检查存储空间

   设置 → 存储
   要求：可用空间 > 500MB

Windows 版

1. 检查运行库

   1. 下载安装 .NET Framework 4.5+
   2. 下载安装 Visual C++ Redistributable

2. 以管理员身份运行

   右键点击富掌柜图标 → 以管理员身份运行

3. 检查杀毒软件

   将富掌柜添加到杀毒软件白名单
   或暂时关闭杀毒软件测试

4. 查看错误日志

   日志位置：C:\Users\用户名\AppData\Roaming\富掌柜\logs
   查看最新的错误日志文件

网络连接问题

症状

• 提示"网络连接失败"
• 数据无法同步
• 支付二维码无法生成

排查步骤

1. 检查网络连接

   # Windows
   ping www.baidu.com
   
   # 安卓
   浏览器访问网页测试

2. 检查网络权限

   安卓：设置 → 应用管理 → 富掌柜 → 权限 → 开启网络权限

3. 检查防火墙

   Windows：控制面板 → Windows Defender 防火墙 → 允许应用通过防火墙
   确保富掌柜在允许列表中

4. 检查代理设置

   如使用代理，在富掌柜设置中配置代理
   设置 → 网络设置 → 代理设置

5. 切换网络测试

   WiFi 切换到 4G/5G 测试
   或更换其他 WiFi 网络

登录问题

症状

• 无法登录
• 提示"账号或密码错误"
• 登录后自动退出

排查步骤

1. 检查账号密码

   1. 确认输入正确（注意大小写）
   2. 尝试重置密码
   3. 确认账号未被禁用

2. 检查网络

   登录需要网络连接，检查网络是否正常

3. 清除登录缓存

   安卓：设置 → 应用管理 → 富掌柜 → 存储 → 清除数据
   Windows：删除 C:\Users\用户名\AppData\Roaming\富掌柜\config 目录

4. 检查账号状态

   联系管理员确认账号状态：
   - 是否被禁用
   - 是否已过期
   - 是否在其他设备登录

打印机故障

症状

• 无法打印小票
• 打印内容乱码
• 打印不完整

排查步骤

通用排查

1. 检查打印机状态

   - 电源是否开启
   - 纸张是否充足
   - 纸仓是否盖好
   - 是否有卡纸

2. 检查连接

   - USB线是否插紧
   - 蓝牙是否配对成功
   - 打印机是否在线

3. 测试打印

   富掌柜：设置 → 打印设置 → 测试打印

安卓蓝牙打印机

1. 重新配对

   1. 手机蓝牙设置中取消配对
   2. 打印机重新进入配对模式
   3. 重新搜索并配对
   4. 富掌柜中选择新配对的打印机

2. 检查蓝牙权限

   设置 → 应用管理 → 富掌柜 → 权限 → 开启蓝牙权限

3. 距离检查

   确保手机与打印机距离 < 10米
   避免障碍物阻挡

Windows USB 打印机

1. 检查驱动

   1. 设备管理器查看打印机状态
   2. 如有黄色感叹号，重新安装驱动
   3. 从打印机官网下载最新驱动

2. 更换 USB 口

   尝试更换其他 USB 接口
   避免使用 USB 扩展坞

3. 检查打印队列

   控制面板 → 设备和打印机 → 查看打印队列
   取消所有挂起的打印任务

打印内容问题

问题	原因	解决
乱码	编码问题	设置 → 打印设置 → 选择正确的编码（UTF-8/GBK）
内容不全	纸张宽度设置错误	设置正确的纸张宽度（58mm/80mm）
打印模糊	打印头脏或老化	清洁打印头或更换打印机
内容偏移	纸张未放好	重新装纸，确保纸张对齐

扫码问题

症状

• 扫码枪无法输入
• 扫码无反应
• 扫码后内容错误

排查步骤

有线扫码枪

1. 检查连接

   - USB 线是否插紧
   - 扫码枪是否有声音提示
   - 指示灯是否正常

2. 测试输入

   1. 打开记事本
   2. 扫描任意条码
   3. 看是否能输入字符

3. 检查输入法

   切换到英文输入法测试
   某些输入法可能拦截扫码输入

4. 恢复出厂设置

   扫描扫码枪说明书中的恢复出厂设置条码

蓝牙扫码枪

1. 重新配对

   1. 取消之前的蓝牙配对
   2. 重新配对连接
   3. 测试扫码

2. 检查电量

   低电量可能导致连接不稳定
   充电后重试

扫码识别问题

问题	原因	解决
无法识别	条码模糊/损坏	手动输入条码数字
识别错误	条码类型不支持	检查条码格式（EAN/UPC/Code128）
扫码慢	扫码枪设置问题	调整扫码枪扫描模式为连续扫描

支付问题

微信支付失败

症状

• 二维码无法生成
• 顾客扫码后支付失败
• 支付后系统未收到通知

排查步骤

1. 检查商户配置

   设置 → 支付设置 → 微信支付
   确认：
   - 商户号正确
   - API密钥正确
   - 证书未过期

2. 检查网络

   支付需要连接微信支付服务器
   检查网络是否通畅

3. 检查限额

   确认未超过微信支付限额
   大额支付可能需要额外认证

4. 查看支付日志

   富掌柜后台 → 支付记录 → 查看失败原因

支付宝支付失败

排查步骤与微信支付类似，检查：

• 支付宝商户配置
• 公钥私钥配置
• 网络连接

支付成功但系统未确认

1. 手动查询

   订单详情 → 查询支付状态

2. 等待自动同步

   系统会定时同步支付状态
   一般 1-5 分钟内自动更新

3. 强制完成

   如确认已扣款，可手动标记为已支付
   需要店长权限

数据同步问题

症状

• 数据不更新
• 多设备数据不一致
• 订单丢失

排查步骤

1. 检查网络

   数据同步需要网络连接
   检查网络是否正常

2. 手动同步

   首页下拉刷新
   或点击「同步数据」按钮

3. 检查账号

   确认多设备登录的是同一账号
   不同账号数据不互通

4. 清除缓存

   设置 → 数据管理 → 清除缓存
   重新登录后数据会重新同步

系统卡顿

症状

• 操作响应慢
• 界面卡顿
• 频繁无响应

排查步骤

安卓版

1. 清理内存

   1. 关闭其他后台应用
   2. 清理手机内存
   3. 重启富掌柜

2. 清理数据缓存

   设置 → 应用管理 → 富掌柜 → 存储 → 清除缓存

3. 检查存储空间

   确保可用存储空间 > 1GB

Windows 版

1. 关闭其他程序

   关闭不必要的程序释放内存

2. 检查磁盘空间

   确保系统盘可用空间 > 5GB

3. 检查 CPU 占用

   任务管理器查看 CPU 占用
   如占用过高，检查是否有其他程序占用资源

数据库错误

症状

• 提示"数据库错误"
• 无法保存数据
• 查询失败

排查步骤

1. 重启应用

   完全关闭后重新打开

2. 修复数据库

   设置 → 数据管理 → 修复数据库

3. 恢复备份

   如修复无效，可恢复之前的备份
   设置 → 数据管理 → 数据恢复

4. 重新安装

   备份数据后卸载重装

其他故障

钱箱无法弹出

1. 检查连接

   确认钱箱线连接到打印机钱箱口

2. 检查设置

   设置 → 打印设置 → 开启「自动开钱箱」

3. 手动测试

   用钥匙手动打开钱箱
   检查钱箱是否卡住

读卡器无法使用

1. 检查连接

   确认读卡器 USB 连接正常

2. 检查驱动

   设备管理器查看读卡器状态
   安装或更新驱动程序

3. 测试读卡

   使用其他卡片测试
   确认卡片未损坏

联系技术支持

如果以上方法无法解决问题，请联系技术支持：

准备信息

联系前请准备以下信息：

1. 基本信息

   • 商户名称和账号
   • 设备型号和系统版本
   • 富掌柜版本号

2. 问题描述

   • 故障现象
   • 发生时间
   • 操作步骤

3. 错误信息

   • 错误提示截图
   • 错误代码（如有）
   • 日志文件（Windows版）

联系方式

• 在线客服：工作日 9:00-21:00
• 客服热线：400-995-7881
• 远程协助：客服可安排技术人员远程协助

紧急处理

如遇紧急故障影响营业：

1. 立即启用备用收银方式（如手工记账）
2. 联系客服电话紧急处理
3. 保留相关凭证和数据
4. 等待技术支持解决