next-intl 配置后 404，一般是 middleware 匹配规则不对。检查 middleware.ts 中 matcher 配置，确保排除了 /api、/_next、/admin 等非国际化路径。另外检查 defaultLocale 和 locales 配置是否正确。 useSession() 返回 null，检查：① SessionProvider 是否包裹了组件 ② session 是否过期 ③ 服务端 auth() 是否正常 ④ 跨域 cookie 问题 ⑤ middleware 是否拦截了 auth 回调。 Zod refine 校验不触发，检查：① refine 是否在 schema 末尾 ② 是否用了 safeParse（parse 会抛错） ③ refine 的 path 是否正确指向字段 ④ 异步 refine 用 superRefine + async。 Next.js 动态 import 水合报错，可能是动态组件的 SSR 输出与客户端不一致。加 ssr: false 避免服务端渲染，或确保组件在 SSR 和 CSR 中输出一致。
我的踩坑经验：Auth.js JWT 不更新是因为没处理 trigger === 'update'，要加 useSession().update()。欢迎大家补充。
有个相关问题想请教：Vercel 环境变量改了要重新部署才生效，NEXT_PUBLIC_ 变量尤其如此。效果因项目而异，建议实际测试。
补充一个边界情况：Prisma 连接池在 Serverless 环境设 connection_limit=1，加 ?pgbouncer=true。感谢楼主的启发。
Auth.js JWT 不更新是因为没处理 trigger === 'update'，要加 useSession().update()。
我做了类似的对比实验：middleware 里 pathname 含 locale 前缀，用 includes() 不要用精确匹配。希望少走弯路。
我的结论恰恰相反：cookies().set() + redirect() 在 Server Component 不兼容，改用 Server Action。踩了很多坑才总结出来的。
有个相关问题想请教：useSession() 返回 null 检查 SessionProvider 是否包裹了组件。
我之前也遇到过类似问题，Vercel 环境变量改了要重新部署才生效，NEXT_PUBLIC_ 变量尤其如此。期待更多实战经验分享。
我做了类似的对比实验：cookies().set() + redirect() 在 Server Component 不兼容，改用 Server Action。欢迎大家补充。
revalidatePath 路径要含 locale 前缀，如 /zh/forum/thread/xxx。
这个问题我研究过一阵，Vercel 环境变量改了要重新部署才生效，NEXT_PUBLIC_ 变量尤其如此。如果有更好的方案求分享。
这个思路很巧妙，next/dynamic + ssr:false 不能在 Server Component 用，要包一层 'use client'。欢迎私信深入交流。
结合我最近的项目经验：next/dynamic + ssr:false 不能在 Server Component 用，要包一层 'use client'。后续有新发现再来更新。
结合我最近的项目经验：middleware 里 pathname 含 locale 前缀，用 includes() 不要用精确匹配。希望对你有帮助。
上周刚好踩了这个坑，Prisma $queryRaw 的 camelCase 列名必须加双引号，这是个经典坑。
分享一下我的做法：useSession() 返回 null 检查 SessionProvider 是否包裹了组件。有疑问可以继续问。
有个细节值得注意：useSession() 返回 null 检查 SessionProvider 是否包裹了组件。如果有更好的方案求分享。
说个反直觉的发现：Prisma $queryRaw 的 camelCase 列名必须加双引号，这是个经典坑。感谢楼主的启发。
middleware 里 pathname 含 locale 前缀，用 includes() 不要用精确匹配。
middleware 里 pathname 含 locale 前缀，用 includes() 不要用精确匹配。