next/image 图片模糊或变形，检查：① 是否设置了 width/height 或 fill ② fill 模式需要父容器 position: relative ③ priority 只给 LCP 图片 ④ sizes 属性帮助浏览器选择正确尺寸 ⑤ 避免在 Server Component 中用 ssr:false 包装。 next-intl 配置后 404，一般是 middleware 匹配规则不对。检查 middleware.ts 中 matcher 配置，确保排除了 /api、/_next、/admin 等非国际化路径。另外检查 defaultLocale 和 locales 配置是否正确。 Tailwind v4 升级后样式失效，大版本升级有 breaking changes。检查：① tailwind.config.ts 是否用了 v3 语法 ② @tailwind 指令改为 @import 'tailwindcss' ③ content 路径配置 ④ 自定义插件兼容性。建议看官方迁移指南。
补充一点：Server Action 提交后不跳转，用 window.location.href 替代 router.push。如有不对请指正。
这个方案我试过，middleware 里 pathname 含 locale 前缀，用 includes() 不要用精确匹配。踩了很多坑才总结出来的。
这个问题我研究过一阵，middleware 里 pathname 含 locale 前缀，用 includes() 不要用精确匹配。细节可以再展开讨论。
分享一下我的做法：hydration mismatch 一般是服务端客户端渲染不一致，加 suppressHydrationWarning 试试。
讲个真实案例：cookies().set() + redirect() 在 Server Component 不兼容，改用 Server Action。如果有更好的方案求分享。
实操中我发现：middleware 里 pathname 含 locale 前缀，用 includes() 不要用精确匹配。后续有新发现再来更新。
我调研过这块，Prisma 连接池在 Serverless 环境设 connection_limit=1，加 ?pgbouncer=true。欢迎大家补充。
上周刚好踩了这个坑，revalidatePath 路径要含 locale 前缀，如 /zh/forum/thread/xxx。希望少走弯路。
实操中我发现：Auth.js JWT 不更新是因为没处理 trigger === 'update'，要加 useSession().update()。如果有更好的方案求分享。
不同场景下结论可能不同：Server Action 提交后不跳转，用 window.location.href 替代 router.push。如有不对请指正。
我的项目里也用了这个方案，Prisma 连接池在 Serverless 环境设 connection_limit=1，加 ?pgbouncer=true。欢迎交流讨论。
Tailwind v4 升级后 @tailwind 指令改为 @import 'tailwindcss'。
说说我自己的经历：Auth.js JWT 不更新是因为没处理 trigger === 'update'，要加 useSession().update()。
我的团队是这样做的：next/dynamic + ssr:false 不能在 Server Component 用，要包一层 'use client'。后续有新发现再来更新。
说说我自己的经历：Prisma 连接池在 Serverless 环境设 connection_limit=1，加 ?pgbouncer=true。有疑问可以继续问。
有个细节值得注意：useSession() 返回 null 检查 SessionProvider 是否包裹了组件。
revalidatePath 路径要含 locale 前缀，如 /zh/forum/thread/xxx。
结合我最近的项目经验：hydration mismatch 一般是服务端客户端渲染不一致，加 suppressHydrationWarning 试试。感谢楼主的启发。
实操中我发现：next/dynamic + ssr:false 不能在 Server Component 用，要包一层 'use client'。实践出真知，建议动手试试。
cookies().set() + redirect() 在 Server Component 不兼容，改用 Server Action。