Auth.js session 中 role 字段缺失，检查 JWT callback 是否把 role 写入 token，session callback 是否把 token.role 写入 session.user.role。两步缺一不可。 Next.js 15 中 cookies().set() 后跟 redirect() 不兼容，因为 redirect() 抛出特殊错误终止请求，不会包含之前设置的 cookie。解决：用 Server Action（cookies().set 在 Action 中正常工作）或渲染客户端组件处理。 Auth.js 5 beta 的 session 丢失问题，常见原因：① AUTH_SECRET 未配置或变了 ② cookie 被中间件清除 ③ JWT 过期。排查：检查 AUTH_SECRET 是否一致，middleware 中是否有不必要的 Set-Cookie，callbacks.jwt 是否正确返回 token。
补充一点：Auth.js JWT 不更新是因为没处理 trigger === 'update'，要加 useSession().update()。希望少走弯路。
这个思路很巧妙，Tailwind v4 升级后 @tailwind 指令改为 @import 'tailwindcss'。
补充一个边界情况：useSession() 返回 null 检查 SessionProvider 是否包裹了组件。欢迎大家补充。
从另一个角度看：Prisma $queryRaw 的 camelCase 列名必须加双引号，这是个经典坑。后续有新发现再来更新。
我的结论恰恰相反：Server Action 提交后不跳转，用 window.location.href 替代 router.push。这只是个人经验，不一定通用。
有个更优的方案：hydration mismatch 一般是服务端客户端渲染不一致，加 suppressHydrationWarning 试试。
反对一下，我的测试结果不是这样：middleware 里 pathname 含 locale 前缀，用 includes() 不要用精确匹配。我也还在探索中。
补充一个可能被忽略的点：useSession() 返回 null 检查 SessionProvider 是否包裹了组件。细节可以再展开讨论。
有个细节值得注意：middleware 里 pathname 含 locale 前缀，用 includes() 不要用精确匹配。仅供参考，具体还是要看你的场景。
我的项目里也用了这个方案，useSession() 返回 null 检查 SessionProvider 是否包裹了组件。如果有更好的方案求分享。
补充一点：Vercel 环境变量改了要重新部署才生效，NEXT_PUBLIC_ 变量尤其如此。感谢楼主的启发。
Prisma 连接池在 Serverless 环境设 connection_limit=1，加 ?pgbouncer=true。
我的实践经验和你的不太一样：cookies().set() + redirect() 在 Server Component 不兼容，改用 Server Action。有疑问可以继续问。
Vercel 环境变量改了要重新部署才生效，NEXT_PUBLIC_ 变量尤其如此。
我的理解是：hydration mismatch 一般是服务端客户端渲染不一致，加 suppressHydrationWarning 试试。有疑问可以继续问。
补充一点：useSession() 返回 null 检查 SessionProvider 是否包裹了组件。后续有新发现再来更新。
结合我最近的项目经验：Prisma $queryRaw 的 camelCase 列名必须加双引号，这是个经典坑。这只是个人经验，不一定通用。
我的团队是这样做的：revalidatePath 路径要含 locale 前缀，如 /zh/forum/thread/xxx。如有不对请指正。
hydration mismatch 一般是服务端客户端渲染不一致，加 suppressHydrationWarning 试试。
Auth.js JWT 不更新是因为没处理 trigger === 'update'，要加 useSession().update()。