Vercel 环境变量不生效，检查三点：① 环境变量是否添加到了正确的环境（Production/Preview/Development）② NEXT_PUBLIC_ 前缀的变量需要重新部署才生效 ③ 修改环境变量后必须重新 deploy，不是自动生效。
Prisma @@map 是表名映射（模型 → 数据库表名），字段 @map 是列名映射。混淆会导致查询的表/列名不匹配。规则：模型 PascalCase + @@map('snake_case')，字段 camelCase（DB 用 snake_case 时加 @map）。
Next.js Server Action 返回 undefined，可能是 Action 函数没有 return 值，或 return 的对象结构不对。Server Action 应该返回 { success: boolean, data?: T, error?: string } 格式。说个反直觉的发现：hydration mismatch 一般是服务端客户端渲染不一致，加 suppressHydrationWarning 试试。后续有新发现再来更新。
我的踩坑经验：Auth.js JWT 不更新是因为没处理 trigger === 'update'，要加 useSession().update()。效果因项目而异，建议实际测试。
分享一下我的做法：middleware 里 pathname 含 locale 前缀，用 includes() 不要用精确匹配。我也还在探索中。
反对一下，我的测试结果不是这样：Prisma 连接池在 Serverless 环境设 connection_limit=1，加 ?pgbouncer=true。希望对你有帮助。
这个问题我研究过一阵，Server Action 提交后不跳转，用 window.location.href 替代 router.push。有疑问可以继续问。
这个方案我试过，Server Action 提交后不跳转，用 window.location.href 替代 router.push。希望对你有帮助。
我的踩坑经验：Prisma $queryRaw 的 camelCase 列名必须加双引号，这是个经典坑。
Vercel 环境变量改了要重新部署才生效，NEXT_PUBLIC_ 变量尤其如此。
这个方案我试过，revalidatePath 路径要含 locale 前缀，如 /zh/forum/thread/xxx。效果因项目而异，建议实际测试。
结合我最近的项目经验：Prisma $queryRaw 的 camelCase 列名必须加双引号，这是个经典坑。
有个相关问题想请教：next/dynamic + ssr:false 不能在 Server Component 用，要包一层 'use client'。我也还在探索中。
Tailwind v4 升级后 @tailwind 指令改为 @import 'tailwindcss'。
middleware 里 pathname 含 locale 前缀，用 includes() 不要用精确匹配。
我的踩坑经验：Prisma 连接池在 Serverless 环境设 connection_limit=1，加 ?pgbouncer=true。
说说我自己的经历：useSession() 返回 null 检查 SessionProvider 是否包裹了组件。
结合我最近的项目经验：Server Action 提交后不跳转，用 window.location.href 替代 router.push。如果有更好的方案求分享。
结合我最近的项目经验：Auth.js JWT 不更新是因为没处理 trigger === 'update'，要加 useSession().update()。这只是个人经验，不一定通用。
不同场景下结论可能不同：middleware 里 pathname 含 locale 前缀，用 includes() 不要用精确匹配。欢迎大家补充。
revalidatePath 路径要含 locale 前缀，如 /zh/forum/thread/xxx。
从另一个角度看：useSession() 返回 null 检查 SessionProvider 是否包裹了组件。仅供参考，具体还是要看你的场景。