Prisma $transaction 中嵌套查询限制

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

Next.js 路由组 layout 中调用 auth() 报错，因为 layout 是所有子页面的公共外壳，async layout 会拖慢导航。解决：layout 保持同步，用客户端组件 + useSession() 读取 session 缓存。

Auth.js JWT token 中字段不更新，因为 JWT 是有状态的快照。修改用户字段后需要用 useSession().update() 刷新客户端 session，同时 JWT callback 中处理 trigger === 'update' 从 DB 读取最新值更新 token。

Prisma $queryRaw 中 camelCase 列名必须加双引号：SELECT "newUserQuota" FROM users。不加双引号 PostgreSQL 会当作不区分大小写的标识符，找不到 camelCase 列。TS 类型声明也要与 SQL 别名一致。

React Server Component 中使用 useState 报错，因为 Server Component 不能用 hooks。解决：① 把需要状态的组件拆成 Client Component（加 'use client'） ② 父组件保持 Server Component 做数据获取，子组件 Client 做交互。