常见问题

1. 手机摄像头扫不了码？#

浏览器要求 HTTPS 才能调用摄像头。确认域名证书有效，并且不是自签名证书； 如果通过 IP 访问，部分浏览器也会拒绝。

2. USB 扫码枪扫出来是乱码？#

扫码枪一般工作在「键盘楔」模式，需要把输入法切到英文，并确认回车结束符已开启。 如果扫的是中文条码，检查扫码枪的编码设置是否为 UTF-8。

3. 标签打印不出来？#

先看 print-server 是否能单独打印测试页，再检查 WMS 的 PRINT_PROXY_URL 和 PRINT_PROXY_API_KEY。容器之间要加入同一个 Docker 网络。

4. 为什么已拣货的库存还在？#

这是预期行为。拣货只是预占，发运成功才扣库存。如果希望拣货即扣减， 需要调整业务配置，但一般不建议，否则「已拣未发」的货会被重复销售。

5. 怎么备份？#

至少备份 MariaDB 数据卷和上传的标签/附件文件。可以使用 deploy 脚本的 ./deploy.sh backup，也可以直接用 mysqldump。 备份后定期做一次恢复演练，确认备份真的能用。

6. 能不能先不启用授权？#

开发环境可以把 LICENSE_ENFORCE=false，生产环境请按实际授权配置。 授权只影响系统启动和功能范围，不影响数据本身。

注：本文基于 WMS Next 0.1.x 的菜单和接口整理，版本升级后个别路径可能变化。