Next.js App Router 中 parallel route 不渲染

遇到 hydration mismatch 报错，一般是服务端和客户端渲染的 HTML 不一致。常见原因：① 在组件中用了 Date.now() 或 Math.random() ② 用了 window/document 等浏览器 API ③ 服务端和客户端时区不同。解决：把动态值放到 useEffect 里设置，或加 suppressHydrationWarning。

Google OAuth 回调报 OAuthCallback 错误，检查：① GOOGLE_CLIENT_ID/SECRET 是否正确 ② NEXTAUTH_URL 是否与 Google Console 中的回调 URL 一致 ③ redirect URI 是否匹配 ④ 时钟同步问题。

revalidateTag vs revalidatePath：revalidateTag 清除特定 tag 的缓存（fetch 时用 next.tags 标记），revalidatePath 清除特定路径的缓存。数据变更后 revalidatePath 更直接，精细控制用 revalidateTag。

Prisma $transaction 超时回滚，默认超时 5s。长事务用 $transaction(async (tx) => { ... }, { timeout: 30000 }) 设置超时。Serverless 环境注意函数超时限制。