Next.js 15 + Clerk：JWT提示'token-not-active-yet'导致API调用401未授权

开发基于Next.js 15 + Clerk身份验证的应用时，调用API获取用户数据返回401 Unauthorized，错误信息如下：

JWT cannot be used prior to not before date claim (nbf)
生效时间：Thu, 18 Sep 2025 18:47:05 GMT
当前时间：Thu, 18 Sep 2025 07:20:42 GMT
(reason=token-not-active-yet)

已验证：系统时钟正确、.env中Clerk API密钥与控制台一致、已清除存储旧JWT的Cookie，但问题仍存在。

API路由代码（Next.js 15 App Router）：

import { getAuth } from '@clerk/nextjs/server';
import connectDB from '../../../../config/db';
import User from '../../../../models/User';
import { NextResponse } from 'next/server';

export async function GET(request) {
  try {
    const { userId } = getAuth(request);
    if (!userId) {
      return NextResponse.json(
        { success: false, message: "Unauthorized" },
        { status: 401 }
      );
    }

    await connectDB();
    const user = await User.findById(userId)

    if (!user) {
      return NextResponse.json(
        { success: false, message: "User not found" },
        { status: 404 }
      );
    }

    return NextResponse.json({ success: true, user }, { status: 200 });
  } catch (error) {
    const message = error?.message || String(error);
    return NextResponse.json({ success: false, message }, { status: 500 });
  }
}

这个错误核心是Clerk签发的JWT的nbf（生效时间）晚于当前服务器时间，即便本地时钟正确，也可能存在以下情况：

• 检查部署环境时钟同步
  本地时钟正常不代表服务器/容器环境时钟同步正常：

  • Vercel部署：直接重新部署触发环境刷新，平台服务器时钟通常自动同步。
  • 自托管服务器：Linux执行ntpdate pool.ntp.org校准时间，Windows检查系统时间同步设置。
  • Docker容器：启动时添加--env TZ=UTC参数，或在Dockerfile中设置时区，避免容器时钟偏移。

• 强制Clerk重新生成JWT
  清除Cookie后仍无效，可能是Clerk会话缓存问题：

  • 让用户登出再重新登录，触发Clerk生成新JWT。
  • 登录Clerk控制台，找到对应用户的旧会话并手动撤销，强制生成新会话令牌。

• 临时调整Clerk JWT配置
  若无法立即修复时钟，可在Clerk控制台临时调整JWT生效偏移：
  进入「应用→会话设置→JWT设置」，找到Not Before (nbf) Offset，设置负数偏移（如-300，即提前5分钟生效），但这仅为应急方案，优先修复时钟同步。

• 更新Clerk SDK版本
  Next.js 15属于较新版本，可能存在SDK兼容性问题：
  执行npm list @clerk/nextjs查看版本，若不是最新稳定版，更新到最新：

  npm install @clerk/nextjs@latest
  

• 自定义JWT验证（临时调试）
  以上方法均无效时，可临时忽略nbf检查（不推荐长期使用）：
  修改API路由，用verifyToken自定义验证逻辑：

  import { verifyToken } from '@clerk/nextjs/server';
  import connectDB from '../../../../config/db';
  import User from '../../../../models/User';
  import { NextResponse } from 'next/server';
  
  export async function GET(request) {
    try {
      const authHeader = request.headers.get('authorization');
      if (!authHeader || !authHeader.startsWith('Bearer ')) {
        return NextResponse.json({ success: false, message: "Unauthorized" }, { status: 401 });
      }
      const token = authHeader.split(' ')[1];
      // 临时忽略nbf检查
      const decoded = await verifyToken(token, {
        ignoreExpiration: false,
        ignoreNotBefore: true
      });
      const userId = decoded.sub;
      if (!userId) {
        return NextResponse.json({ success: false, message: "Unauthorized" }, { status: 401 });
      }
  
      await connectDB();
      const user = await User.findById(userId)
  
      if (!user) {
        return NextResponse.json(
          { success: false, message: "User not found" },
          { status: 404 }
        );
      }
  
      return NextResponse.json({ success: true, user }, { status: 200 });
    } catch (error) {
      const message = error?.message || String(error);
      return NextResponse.json({ success: false, message }, { status: 500 });
    }
  }
  

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