Tailwind v4 容器查询不生效

Prisma migrate 报 database does not exist，需要先创建数据库。用 npx prisma db push 或手动 createdb。如果是 Vercel Postgres 或 Supabase，确保 DATABASE_URL 指向正确的数据库实例。

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

Auth.js 5 beta 的 session 丢失问题，常见原因：① AUTH_SECRET 未配置或变了 ② cookie 被中间件清除 ③ JWT 过期。排查：检查 AUTH_SECRET 是否一致，middleware 中是否有不必要的 Set-Cookie，callbacks.jwt 是否正确返回 token。

Zod refine 校验不触发，检查：① refine 是否在 schema 末尾 ② 是否用了 safeParse（parse 会抛错） ③ refine 的 path 是否正确指向字段 ④ 异步 refine 用 superRefine + async。

Prisma 乐观锁并发更新冲突，用 $executeRaw 原子更新：UPDATE table SET count = count + 1 WHERE id = $1 AND count < $limit。配合 FOR UPDATE 行锁防并发竞争。