Prisma enum 类型在 TypeScript 中报错

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

Prisma 连接池超时一般是 connection_limit 设置不当。Serverless 环境（Vercel）建议 connection_limit=1，因为每个函数实例独立连接。如果用 PgBouncer 或 Supabase connection pooler，URL 加 ?pgbouncer=true&connection_limit=1。

Prisma 软删除查询过滤重复，用 middleware 自动过滤 deletedAt: null。Prisma 6 支持 extends 中间件，在 query 前自动加 deletedAt 过滤条件，避免每次查询都手动加。

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

Auth.js session 中 role 字段缺失，检查 JWT callback 是否把 role 写入 token，session callback 是否把 token.role 写入 session.user.role。两步缺一不可。