PAYATHON 2026

Expo 中 Supabase setSession 在 magic-link 登录时挂起如何排查?

数据小陈

结论

现有信息不足以确认根因,不能仅凭 WebCrypto 警告就认定缺少 crypto.subtle 导致挂起。建议先检查应用中所有 onAuthStateChange 监听器,再分别确认 Auth 初始化、网络请求和 session 存储是否完成。

Supabase 官方记录过在 onAuthStateChange 内执行异步 Supabase 调用导致客户端死锁的问题。这与“进入认证成功分支后一直没有返回”的现象相符,但题目没有提供监听器代码,因此目前只能将其作为优先排查项。Supabase 官方排障说明

为什么错误分支正常仍不能排除 Auth 内部问题?

otp_expired 分支解析 URL 后直接返回,没有执行 setSession()。它能说明 deep link 和错误路由正常,但没有覆盖成功登录时的网络请求、session 写入和认证事件通知。

以 @supabase/auth-js 的 v2.71.1 实现为例,setSession() 会等待初始化和内部锁;未过期的 access token 会用于获取用户信息,之后保存 session 并等待认证监听器完成。这些步骤中任何一步持续等待,都可能让外层 await 无法结束。该版本仅用于说明调用机制,不代表题目实际安装的版本。对应版本源码

因此,“停在 setSession start”尚不能区分请求未返回、存储未完成或监听器阻塞。

先检查所有 onAuthStateChange 监听器

检查 AuthProvider、Context、状态管理和根布局中的订阅,尤其是这种写法:

// 排查时重点检查这种模式
supabase.auth.onAuthStateChange(async (_event, session) => {
  if (!session) return;

  await supabase.auth.getSession();
  await loadProfile(); // 内部也可能调用 Supabase
});

如果所用版本在通知监听器时仍持有认证锁,而监听器又在等待需要该锁的操作,就可能形成循环等待。即使回调没有直接调用 Supabase,也要检查它等待的函数。

可以暂时移除所有业务监听器,冷启动应用,使用新链接重试。仅新增一个简单监听器,并不能消除已有监听器造成的阻塞。

恢复订阅时,可以让回调只更新 React 状态,再用独立的 effect 加载业务数据。下面的代码放在现有组件中,setAuthSession 表示该组件的 session 状态 setter:

useEffect(() => {
  const { data: { subscription } } =
    supabase.auth.onAuthStateChange((event, session) => {
      console.log('[auth] event:', event, 'hasSession:', !!session);
      setAuthSession(session);
    });

  return () => subscription.unsubscribe();
}, []);

不要让认证监听器返回 loadProfile() 的 Promise。移除业务监听器后如果仍然挂起,就继续检查下面的等待环节,不能将死锁当作已确认的结论。

WebCrypto 警告说明了什么?

在上述版本中,generatePKCEChallenge() 如果缺少所需的 WebCrypto 能力,会打印这条警告并返回 verifier,采用 plain,不会停在那里等待 crypto.subtle.digest()。因此,这条警告本身不能证明 digest 挂起。PKCE challenge 实现

要排查改成 implicit 后仍有警告的原因,可以捕获警告的调用栈,并检查:

  • 是否还有其他 createClient() 实例使用 PKCE 配置。
  • 发送链接的模块与处理回调的模块是否导入同一个 client。
  • Fast Refresh 后是否仍保留旧实例、订阅或旧配置;用完整重启做对照。

react-native-get-random-values 提供随机数能力,不代表它提供完整的 WebCrypto。只有调用栈或独立测试确认某条必经路径需要缺失的 API,才有依据补充对应实现。不要直接将 digestStringAsync 赋给 crypto.subtle.digest,两者的参数和返回值约定需要适配。

用日志定位真正没有完成的步骤

先记录确切的依赖版本,不能只记录 v2.x latest:

npm ls @supabase/supabase-js @supabase/auth-js

接着在不输出凭据的前提下观察以下边界:

  1. 在处理链接前,单独调用一次 getSession()。如果它也不返回,应优先检查初始化、存储或既有认证操作;不要在认证监听器内做这个探测。
  2. 通过网络检查器或受控的 fetch 包装记录 Auth 请求的开始、状态码和结束。按实际版本观察 /auth/v1/user、/auth/v1/token 等请求,不能用业务数据表查询成功替代 Auth 请求验证。
  3. 为 AsyncStorage adapter 的 getItem、setItem、removeItem 记录开始和完成,只记录操作类型,不记录存储内容。
  4. 观察是否已经收到 SIGNED_IN,以及相关监听器是否返回。收到事件说明流程已经推进,但不等于整个 setSession() 已完成。

还可以在最小复现中分别临时关闭持久化和自动刷新,逐项对照。如果关闭后恢复正常,只能说明相关路径值得继续检查,不能直接归因于 AsyncStorage 或自动刷新。诊断 client 应与正常应用隔离运行,避免多个实例同时处理相同会话。

原代码打印了完整回调 URL,其中可能包含 access token 和 refresh token。排查日志应改为记录 token 是否存在及步骤耗时。

给调用增加可观察的超时和异常处理

原代码中的 run() 没有显式处理 Promise rejection。可以先捕获异常,再通过超时结束无限加载状态:

async function withTimeout<T>(
  task: Promise<T>,
  ms: number
): Promise<T> {
  let timer: ReturnType<typeof setTimeout> | undefined;

  try {
    return await Promise.race([
      task,
      new Promise<never>((_, reject) => {
        timer = setTimeout(() => {
          reject(new Error(`Auth operation timed out after ${ms}ms`));
        }, ms);
      }),
    ]);
  } finally {
    if (timer !== undefined) clearTimeout(timer);
  }
}

// 替换现有 run() 中的 setSession 调用部分
const { data, error } = await withTimeout(
  supabase.auth.setSession({
    access_token: fragment.accessToken,
    refresh_token: fragment.refreshToken,
  }),
  15000 // 示例诊断阈值,可按实际情况调整
);

if (error) throw error;
if (!data.session) throw new Error('No session returned');

console.log('[callback] setSession completed');

// 在 effect 末尾为 run() 添加 rejection handler
// void run().catch((error) => {
//   console.error('[callback] auth failed:', error.message);
//   // 更新错误状态并结束加载
// });

这个超时只会结束外层等待,不会取消底层 Auth 操作,也不会释放可能阻塞的锁。底层操作仍可能在超时后成功,因此不要立即用同一组凭据自动重试。

另外,processedRef.current = url 在成功前就已执行,失败后会阻止再次处理同一 URL。重试逻辑应区分处理中、成功和失败,并考虑超时后才返回的结果。

是否需要换 polyfill、降级或改用密码登录?

目前没有依据推荐特定的 polyfill 或降级版本,也不能断言某组 Expo SDK 与 supabase-js 组合一定可用。应先固定当前依赖版本,建立移除业务监听器的最小复现,再根据已确认的缺陷或变更记录对照版本。

email/password 登录同样涉及 session 建立、存储和认证状态通知。如果阻塞发生在这些共用环节,换一种登录方式仍可能遇到同样的问题。先确定具体的等待边界,再决定是否需要临时替代登录方式。

备注:内容仅供参考。