API02003: 令牌无效
这意味着什么
所使用的身份验证令牌未被服务器识别。这与过期令牌不同——此令牌从未有效或已被撤销。
常见原因
- 令牌被撤销 — 管理员撤销了会话
- 令牌损坏 — 存储或传输过程中数据损坏
- 服务器密钥更改 — 服务器密钥更改，导致所有令牌无效
- 错误的服务器 — 来自不同 WordPress 安装的令牌
服务器错误映射
当服务器返回时，会触发此错误代码：
| 服务器代码 | 来源 |
|---|---|
jwt_auth_invalid_token | JWT Authentication 插件 |
如何修复
1. 再次登录
清除会话并重新登录。如果此设备上可能有尚未同步到店铺的销售记录，请先按照第 2 步警告中的说明进行检查：
- 完全注销
- 关闭并重新打开 POS
- 使用您的凭据登录
2. 清除应用程序数据
请先检查是否有未保存的工作
清除本地数据或重新安装应用会删除此设备上尚未同步到店铺的所有内容，包括离线期间完成的销售、未结购物车以及未保存的编辑。清除前，请打开 Store health → Database，确认没有记录显示为暂存或从未到达服务器；然后打开 Store health → Logs，确认 0 条记录卡住且 0 项更改等待发送；接着完成或记录每个未结购物车。如果您的 WCPOS 没有 Store health 页面，请先更新 WCPOS，再进行检查。如果存在任何记录或等待发送的内容，或者无法检查，请勿清除；请咨询店铺所有者或联系支持团队。
只有在无法退出登录时，并且完成上述检查后，才执行以下操作：
- 清除 POS 应用程序缓存/数据
- 在网页上：清除网站的浏览器 Cookies 和本地存储
- 在桌面上：检查应用设置是否有“清除数据”选项
3. 检查服务器配置
如果问题影响所有用户：
- 检查 WordPress 盐值是否已更改
- 验证 JWT 或身份验证插件的设置
- 查看近期的服务器更改
4. 确保您连接到正确的服务器
确保 POS 配置为连接到正确的 WordPress 站点，尤其是在您有多个安装的情况下。