Vercel 构建时 TypeScript 检查失败，可以在 next.config.ts 中设置 typescript.ignoreBuildErrors = true 临时跳过，但不推荐。正确做法：本地运行 npm run typecheck 修复所有类型错误后再部署。 Auth.js JWT token 中字段不更新，因为 JWT 是有状态的快照。修改用户字段后需要用 useSession().update() 刷新客户端 session，同时 JWT callback 中处理 trigger === 'update' 从 DB 读取最新值更新 token。 Vercel NEXT_PUBLIC_ 环境变量不暴露到客户端，检查：① 变量名是否以 NEXT_PUBLIC_ 开头 ② 是否添加到了正确的环境 ③ 修改后是否重新部署 ④ 代码中是否在客户端组件中引用。
我之前也遇到过类似问题，Prisma $queryRaw 的 camelCase 列名必须加双引号，这是个经典坑。欢迎交流讨论。
这个问题我研究过一阵，Auth.js JWT 不更新是因为没处理 trigger === 'update'，要加 useSession().update()。如有不对请指正。
我做了类似的对比实验：next/dynamic + ssr:false 不能在 Server Component 用，要包一层 'use client'。欢迎大家补充。
不同场景下结论可能不同：next/dynamic + ssr:false 不能在 Server Component 用，要包一层 'use client'。细节可以再展开讨论。
不同场景下结论可能不同：revalidatePath 路径要含 locale 前缀，如 /zh/forum/thread/xxx。
讲个真实案例：Prisma $queryRaw 的 camelCase 列名必须加双引号，这是个经典坑。共同进步。
Prisma $queryRaw 的 camelCase 列名必须加双引号，这是个经典坑。
补充一个边界情况：useSession() 返回 null 检查 SessionProvider 是否包裹了组件。希望对你有帮助。
反对一下，我的测试结果不是这样：useSession() 返回 null 检查 SessionProvider 是否包裹了组件。
我的踩坑经验：revalidatePath 路径要含 locale 前缀，如 /zh/forum/thread/xxx。效果因项目而异，建议实际测试。
Tailwind v4 升级后 @tailwind 指令改为 @import 'tailwindcss'。
说个反直觉的发现：useSession() 返回 null 检查 SessionProvider 是否包裹了组件。如有不对请指正。
我做了类似的对比实验：cookies().set() + redirect() 在 Server Component 不兼容，改用 Server Action。
补充一点：revalidatePath 路径要含 locale 前缀，如 /zh/forum/thread/xxx。有疑问可以继续问。
我调研过这块，Prisma $queryRaw 的 camelCase 列名必须加双引号，这是个经典坑。
反对一下，我的测试结果不是这样：hydration mismatch 一般是服务端客户端渲染不一致，加 suppressHydrationWarning 试试。后续有新发现再来更新。
我的看法略有不同：revalidatePath 路径要含 locale 前缀，如 /zh/forum/thread/xxx。
这个观点我很认同，Tailwind v4 升级后 @tailwind 指令改为 @import 'tailwindcss'。
hydration mismatch 一般是服务端客户端渲染不一致，加 suppressHydrationWarning 试试。
这个问题我研究过一阵，cookies().set() + redirect() 在 Server Component 不兼容，改用 Server Action。如有不对请指正。