router.push 不更新 URL，Next.js 15 + next-intl 在 useSession 触发 re-render 时可能取消 router.push 的 startTransition。解决：用 window.location.href 硬导航（认证流程的例外允许裸路径）。
Auth.js session 中 role 字段缺失，检查 JWT callback 是否把 role 写入 token，session callback 是否把 token.role 写入 session.user.role。两步缺一不可。
Next.js Server Action 返回 undefined，可能是 Action 函数没有 return 值，或 return 的对象结构不对。Server Action 应该返回 { success: boolean, data?: T, error?: string } 格式。我的踩坑经验：Prisma $queryRaw 的 camelCase 列名必须加双引号，这是个经典坑。如有不对请指正。
我的团队是这样做的：middleware 里 pathname 含 locale 前缀，用 includes() 不要用精确匹配。欢迎交流讨论。
补充一点：Vercel 环境变量改了要重新部署才生效，NEXT_PUBLIC_ 变量尤其如此。欢迎交流讨论。
我的理解是：Vercel 环境变量改了要重新部署才生效，NEXT_PUBLIC_ 变量尤其如此。如果有更好的方案求分享。
Prisma 连接池在 Serverless 环境设 connection_limit=1，加 ?pgbouncer=true。
说说我自己的经历：middleware 里 pathname 含 locale 前缀，用 includes() 不要用精确匹配。一起学习。
我的理解是：useSession() 返回 null 检查 SessionProvider 是否包裹了组件。仅供参考，具体还是要看你的场景。
我的实践经验和你的不太一样：Prisma $queryRaw 的 camelCase 列名必须加双引号，这是个经典坑。细节可以再展开讨论。
我的踩坑经验：Vercel 环境变量改了要重新部署才生效，NEXT_PUBLIC_ 变量尤其如此。踩了很多坑才总结出来的。
我做了类似的对比实验：Server Action 提交后不跳转，用 window.location.href 替代 router.push。如有不对请指正。
有个相关问题想请教：next/dynamic + ssr:false 不能在 Server Component 用，要包一层 'use client'。效果因项目而异，建议实际测试。
Tailwind v4 升级后 @tailwind 指令改为 @import 'tailwindcss'。
useSession() 返回 null 检查 SessionProvider 是否包裹了组件。
有个更优的方案：middleware 里 pathname 含 locale 前缀，用 includes() 不要用精确匹配。效果因项目而异，建议实际测试。
补充一个边界情况：revalidatePath 路径要含 locale 前缀，如 /zh/forum/thread/xxx。踩了很多坑才总结出来的。
我的团队是这样做的：Auth.js JWT 不更新是因为没处理 trigger === 'update'，要加 useSession().update()。
我的项目里也用了这个方案，revalidatePath 路径要含 locale 前缀，如 /zh/forum/thread/xxx。
next/dynamic + ssr:false 不能在 Server Component 用，要包一层 'use client'。
useSession() 返回 null 检查 SessionProvider 是否包裹了组件。
结合我最近的项目经验：cookies().set() + redirect() 在 Server Component 不兼容，改用 Server Action。踩了很多坑才总结出来的。