Plaid更新模式与重新关联账户区别及ITEM_LOGIN_REQUIRED报错疑问

1. update mode与重新关联账户获取新access_token的核心区别 #

即使不需要保留原access_token，两者的核心差异如下：

• 关联实体不同：update mode在原有Item实体基础上更新验证信息，原Item绑定的历史交易、权限配置、webhook规则都会完整保留；重新关联会生成全新的Item实体，原Item对应的所有数据和新access_token完全解绑，无法复用
• 流程长度不同：update mode会跳过账户选择、权限授权等步骤，仅完成登录凭证验证，流程更短；重新关联需要走完整的Link初始化、权限确认、账户选择全流程
• 异常继承逻辑不同：如果原Item在银行侧存在异常会话标记，重新关联生成新Item可以绕过该标记；update mode基于原Item操作，会继承原Item的所有异常标记

2. update mode能否避免ITEM_LOGIN_REQUIRED反复出现？ #

要分场景判断：

• 如果报错原因是原Item会话过期、银行侧触发临时重验要求，正确完成update mode验证后可以解决该问题，不会反复触发报错
• 如果报错原因是你当前使用Plaid沙箱环境（沙箱为了模拟重验场景，会给测试Item设置数小时的短有效期）、或者对接的银行强制要求定期重验（部分银行无特殊原因也会要求每12/24小时重验一次），不管用update mode还是重新申请新token，到期后都会触发该报错，这种情况需要在业务逻辑里添加ITEM_LOGIN_REQUIRED错误捕获，自动触发update mode流程即可

3. update mode提示凭证不正确的常见排查方案 #

你刚接入Plaid遇到该问题，优先排查以下几点：

• 环境是否匹配：启动update mode传入的access_token所属环境，和初始化Link时用的public key/client_id所属环境是否一致，沙箱/开发/生产环境的密钥和token不能混用
• 入参是否正确：启动update mode时是否传入了正确的item_id，传入的item_id要和access_token对应的Item ID完全一致，不能传错
• 原access_token是否有效：要确认传入的access_token没有被调用/item/remove接口删除，也没有因为长期失效被Plaid自动回收
• Link初始化参数是否正确：update.mode的取值只能是官方指定的in_session或者recreate，不能填写自定义值

内容的提问来源于stack exchange，提问作者user12457151