来源中的信息
发生了什么
当应用在没有用户会话的情况下，把现有非过期离线令牌迁移为过期离线访问令牌时，如果迁移响应丢失，可在初次交换后的最多七天内，使用原非过期令牌和有效客户端凭据重试。
符合条件的重试会返回与初次交换相同的访问令牌和刷新令牌；Shopify 可能延长访问令牌的到期时间，但不会延长刷新令牌的到期时间。
针对某个店铺和应用的恢复能力，会在初次交换七天后、应用成功刷新已签发的令牌对，或后续令牌获取替换该令牌对时结束。
迁移后，原非过期令牌仍不能用于 GraphQL Admin API 请求；现有流程无需为了继续运行而修改。
经营影响
为什么重要
对处理令牌迁移的应用，迁移响应未被接收或持久化时，重试机制提供了不依赖商家重新打开应用的恢复路径。
这项变化主要改善故障恢复而不是改变令牌迁移流程；真正的价值取决于应用能否识别迁移失败、保留原令牌并在恢复窗口内重试。
编辑观察
分析判断
恢复窗口把一次性的迁移响应丢失转化为有时限的可重试状态，机制上降低了短暂网络或持久化故障直接升级为重新授权事件的概率；但证据只确认了官方描述的重试条件，未证明所有失败类型都能恢复，因此商家应把它视为容错补充而非迁移成功保障。
对商家而言，影响集中在依赖后台令牌持续访问店铺数据或执行任务的应用：若应用正确保存原令牌并及时重试，可能减少重新打开应用的中断；若已成功刷新、发生后续令牌获取或超过七天，恢复路径就会关闭，所以不能把“无需重新授权”当作普遍结果。
下一步决策应以迁移日志中的初次交换时间、响应持久化状态和后续刷新状态为边界：只有同时满足未收到或未保存响应、仍在七天内且原令牌与客户端凭据可用时，才值得实施同一请求重试；输入仅来自单一官方更新，尚不足以支持更广泛的成功率或经营效果判断。
适用范围
对卖家的影响
使用受影响应用的商家，遇到迁移期间的访问恢复问题时，重新打开应用并再次授权可能不再是唯一选项，但是否可用取决于应用方的令牌记录和故障处理能力。
如果应用已完成令牌刷新或发生新的令牌获取，原有恢复窗口可能已经失效；商家不应仅凭这项更新推断历史迁移问题仍可恢复。
这项变化对普通店铺操作没有直接配置要求，影响更可能出现在应用维护者处理后台访问、令牌迁移和授权故障的工作流中。
行动建议
现在应该做什么
- 1
核对应用是否使用无用户会话的令牌迁移
now向应用维护者确认是否涉及从非过期离线令牌迁移到过期离线访问令牌；若不涉及该流程，不要为这项更新改动店铺授权设置。
- 2
检查迁移失败后的记录与重试路径
this-week确认应用是否记录初次令牌交换时间、响应是否成功持久化，以及是否能在七天窗口内使用原非过期令牌和有效客户端凭据重试。
- 3
把恢复条件纳入故障处理流程
this-week将成功刷新令牌、后续令牌获取和七天到期视为恢复窗口结束信号；在这些条件出现后，不要继续依赖原令牌重试。
暂时不要做什么
- 不要因为这项更新而修改所有现有令牌流程，也不要把原非过期令牌继续用于 GraphQL Admin API 请求；官方证据仅说明符合条件的迁移重试可恢复令牌对，未扩大原令牌的使用权限。
来源与依据
证据与来源
来源可能仅提供标题或摘要。请结合下方具体证据范围阅读；链接与流程校验不等于独立事实核验。内部置信值是工作流信号，不代表事实正确的概率。
- 01来源链接
More resilient token exchanges when migrating to expiring offline access tokens When you migrate an app from non-expiring offline tokens to expiring offline access tokens without a user session, you can now recover a lost migration response by retrying the exchange with the original non-expiring token for up to seven days. This reduces how often you need a merchant to reopen the app to restore access, but you don’t need to change existing flows to keep them working. What changed When you migrate an existing non-expiring offline token to an expiring offline access token without a user session, an eligible retry using the same original token and client credentials returns the same access-token and refresh-token pair as the initial exchange. On an eligible retry: Shopify returns the same access token and refresh token. Shopify extends the access token’s expiry when needed. Shopify doesn’t extend the refresh token’s expiry. Recovery for a particular store and app ends when any of the following is true: Seven days have passed since the initial exchange for that original token. Your app successfully refreshes the issued pair. A later token acquisition for the same store replaces that pai
Shopify Developer Changelog · 流程状态: single-source
获取时间: 2026年9月29日 16:07 UTC
Claim is bounded to the ingested title or summary; no source body or quotation is retained.