Plaid Link开发问题：Redirect URI失效，OAuth银行流程弹出窗口

• 严格校验redirect_uri的一致性
  确保生成Link Token时传入的redirect_uri和Plaid后台Allowed URI列表里的条目完全一致：

  • 协议（http/https）必须匹配，开发环境注意区分http和https；
  • 端口号不能遗漏，比如http://localhost:3000/callback和http://localhost/callback属于两个不同的URI；
  • 路径的大小写、末尾斜杠都要完全对应，比如/plaid-oauth和/Plaid-OAuth、/plaid-oauth/都会被判定为不匹配。

• 确认Link Token的有效性与初始化逻辑

  • 检查localStorage中存储的Link Token是否为最新生成的，Plaid Link Token默认有效期为30分钟，过期后会导致流程异常；
  • Reinitializing Link场景下，确保初始化Plaid.create()时没有错误覆盖或遗漏参数，不要在初始化配置里传入和Link Token中不一致的redirect_uri。

• 排查浏览器第三方Cookie限制
  开发环境下，Chrome、Edge等浏览器默认拦截第三方Cookie，会导致OAuth流程跳转被阻断，表现为弹出窗口无法正常跳转：

  • 临时在浏览器设置中允许localhost的第三方Cookie；
  • 测试时可使用隐私模式，部分浏览器对localhost的限制在隐私模式下会放宽。

• 核对Plaid后台的环境配置
  确认你添加的redirect_uri是在对应环境的Allowed URI列表中：

  • 如果是开发环境（Development/Sandbox），不要误加到Production环境的列表里；
  • 检查列表中是否存在重复或错误的URI条目，避免干扰匹配逻辑。

• 查看浏览器控制台日志
  打开浏览器开发者工具（F12），切换到Network和Console标签：

  • 观察Plaid相关请求的返回状态，若存在400/403错误，查看响应体中的错误信息（如invalid_redirect_uri）；
  • 检查是否有Cookie相关的警告或错误，这能直接指向浏览器限制问题。

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