跳到主内容
版本: 1.x

API02007: 令牌刷新失败

这意味着什么​

POS 尝试自动续订您的身份验证会话,但刷新请求失败。这通常意味着您需要再次登录。

常见原因​

  • 刷新令牌已过期 — 刷新令牌本身已过期
  • 刷新令牌已被撤销 — 管理员使所有会话失效
  • 服务器错误 — 服务器无法处理刷新请求
  • 网络问题 — 刷新尝试期间的连接问题

如何修复​

1. 再次登录​

最可靠的修复方法:

  1. 登出 POS
  2. 使用您的凭据重新登录
  3. 这将创建一个带有新令牌的新会话

2. 检查网络连接​

如果刷新因网络问题而失败:

  • 验证您的互联网连接
  • 尝试在浏览器中访问您的 WordPress 网站
  • 等待片刻并再试一次

3. 检查服务器状态​

如果服务器存在问题:

  • 验证 WordPress 是否正常运行
  • 检查服务器日志中的 PHP 错误
  • 确保身份验证插件处于活动状态

4. 清除会话数据​

如果问题仍然存在,并且完成下方检查后:

请先检查是否有未保存的工作

清除本地数据或重新安装应用会删除此设备上尚未同步到店铺的所有内容,包括离线期间完成的销售、未结购物车以及未保存的编辑。清除前,请打开 Store health → Database,确认没有记录显示为暂存或从未到达服务器;然后打开 Store health → Logs,确认 0 条记录卡住且 0 项更改等待发送;接着完成或记录每个未结购物车。如果您的 WCPOS 没有 Store health 页面,请先更新 WCPOS,再进行检查。如果存在任何记录或等待发送的内容,或者无法检查,请勿清除;请咨询店铺所有者或联系支持团队。

  • 清除 POS 应用缓存
  • 删除存储的凭据
  • 通过新的登录开始新的会话

自动令牌刷新​

WCPOS 会在令牌过期前自动刷新令牌以维持您的会话。如果此过程反复失败,可能存在需要注意的配置问题。