链接令牌流失败时onExit方法未返回错误，无法区分用户操作场景

核心问题分析 #

当Plaid Link令牌超时（比如等待30分钟后操作），浏览器开发者工具能捕获到400 Bad Request，但onExit回调里无法获取对应错误信息，导致无法区分用户是主动关闭链接流还是遇到了实际异常。

可行解决方案 #

1. 结合onEvent事件记录前置错误 #

初始化Link时，通过onEvent监听ERROR类型事件，提前记录错误详情，再在onExit中结合记录判断退出类型：

let linkError = null;

Plaid.create({
  // 其他必要配置
  onEvent: (eventName, eventData) => {
    if (eventName === 'ERROR') {
      linkError = eventData;
      // 可在此处先完成错误日志上报
    }
  },
  onExit: (exitData) => {
    if (linkError) {
      // 处理异常退出场景（如令牌超时、请求失败）
      console.error('链接流异常退出:', linkError);
      linkError = null; // 重置错误状态
    } else {
      // 用户主动关闭链接流
      console.log('用户主动退出链接流');
    }
  }
}).open();

2. 打开Link前主动校验令牌有效性 #

在调用open()之前，通过Plaid后端接口提前校验Link令牌是否过期，避免用户进入流程后才触发错误：

// 后端校验示例（Node.js）
const plaid = require('plaid');

const client = new plaid.Client({
  clientID: process.env.PLAID_CLIENT_ID,
  secret: process.env.PLAID_SECRET,
  env: plaid.environments.sandbox,
});

async function validateLinkToken(linkToken) {
  try {
    await client.linkTokenGet({ link_token: linkToken });
    return { valid: true };
  } catch (err) {
    return { valid: false, error: err.response.data };
  }
}

// 前端调用校验后再打开Link
validateLinkToken(userLinkToken).then(result => {
  if (!result.valid) {
    alert('链接令牌已过期，请重新获取');
    return;
  }
  // 令牌有效，打开Link流
  Plaid.create({ token: userLinkToken /* 其他配置 */ }).open();
});

3. 捕获初始化阶段的令牌错误 #

如果使用已过期的令牌初始化Link，部分场景下Plaid.create()会直接抛出错误，可通过try-catch捕获：

try {
  const plaidLinkInstance = Plaid.create({
    token: expiredLinkToken,
    // 其他配置
  });
  plaidLinkInstance.open();
} catch (err) {
  console.error('Link令牌无效:', err);
  // 提示用户重新生成令牌
}

关键说明 #

Plaid的onExit回调在令牌超时这类场景下确实不会直接返回错误信息，需要通过onEvent事件补充监听来区分退出原因；提前校验令牌能有效提升用户体验，避免用户进入流程后才遭遇异常。

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