Next.js中Middleware.js里Clerk公共元数据更新延迟问题

这个延迟是因为Clerk的session token（包含sessionClaims）默认带有缓存机制，更新用户元数据后，旧token仍在有效期内，middleware会读取缓存的旧数据；而Clerk管理后台直接查询数据库，所以能即时看到变更。以下是几种可行的解决方法：

1. 更新元数据后强制刷新客户端Session #

在客户端完成publicMetadata更新操作后，立即调用Clerk的session刷新方法，让客户端获取包含最新元数据的新token，后续请求就能让middleware拿到最新数据。

示例代码（React/Next.js客户端）：

import { useClerk } from '@clerk/nextjs';

async function updateUserMetadata(userId, newMetadata) {
  const { clerk, session } = useClerk();
  
  // 更新用户publicMetadata
  await clerk.users.updateUserMetadata(userId, {
    publicMetadata: { ...newMetadata }
  });
  
  // 刷新当前session，获取新的token
  if (session) {
    await session.refresh();
  }
}

2. 在Middleware中直接查询Clerk API获取最新用户数据 #

如果对实时性要求极高，可绕过sessionClaims缓存，直接在middleware中调用Clerk服务端API获取最新用户元数据。但此方法会增加API调用次数，影响性能，需权衡使用。

示例代码（middleware.js）：

import { auth, clerkClient } from '@clerk/nextjs/server';
import { NextResponse } from 'next/server';

export async function middleware(req) {
  const { userId } = await auth(req);
  if (!userId) {
    return NextResponse.redirect(new URL('/sign-in', req.url));
  }

  // 直接从Clerk获取最新用户信息
  const user = await clerkClient.users.getUser(userId);
  const requiredRole = user.publicMetadata.role;

  // 权限校验逻辑
  if (requiredRole !== 'admin') {
    return new Response('权限不足', { status: 403 });
  }

  return NextResponse.next();
}

3. 调整Session TTL（不推荐） #

可在Clerk管理后台调整session的有效期，缩短缓存时间。但此方法会增加用户频繁登录的概率，降低体验，仅作为临时应急方案。

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