Next.js项目部署至Vercel后报500错误 疑与环境变量配置相关

按以下优先级逐一排查，90%以上的同类问题都是配置不匹配导致：

• 首先处理环境变量生效问题：Vercel上修改任何环境变量后必须重新部署才会生效，仅修改变量值不触发重新部署的话，运行时还是读的旧配置。配置时不要在等号两边加空格，也不要在NEXTAUTH_URL末尾加多余斜杠，正确值为https://twitter-clone-seven-coral.vercel.app，不要带结尾的/。同时确认4个环境变量（NEXTAUTH_URL、NEXTAUTH_SECRET、TWITTER_CLIENT_ID、TWITTER_CLIENT_SECRET）的作用范围同时勾选了Production、Preview、Development三个环境，不要只配置在单环境下。
• 修正Twitter开发者平台配置：你之前填的test.com站点地址、localhost回调地址都会触发OAuth校验失败，必须把Website URL改成你的正式Vercel域名，Callback URI精确填写https://twitter-clone-seven-coral.vercel.app/api/auth/callback/twitter，路径必须和NextAuth默认回调路径完全一致，不能多字符、少字符、错大小写。配置保存后等待2-5分钟让Twitter平台配置生效再测试。
• 核对本地代码配置：检查NextAuth配置文件（Pages Router路径为pages/api/auth/[...nextauth].js，App Router路径为app/api/auth/[...nextauth]/route.js），确认Twitter提供者的密钥没有硬编码，都是通过process.env读取环境变量；如果是App Router项目，确认文件正确导出了GET、POST请求处理方法，没有遗漏导出。
• 定位精确报错：以上步骤做完仍报错的话，直接打开Vercel项目控制台的Functions日志，复现500错误时日志会打印明确的错误原因：
  • 如果提示NEXTAUTH_SECRET missing，本地执行openssl rand -hex 32生成一个32位随机字符串，填到Vercel的NEXTAUTH_SECRET环境变量里重新部署即可
  • 如果提示OAuth callback mismatch，回到Twitter开发者平台重新核对回调地址、Client ID、Client Secret三个值，复制密钥时注意不要带前后空格

注意：本地的.env.local文件不会随代码提交到Git，也不会自动同步到Vercel，生产环境所有变量必须在Vercel控制台单独配置，不能依赖本地的环境变量文件。

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