📦 Prisma Schema Analyzer — Prisma 模式分析器

Prisma Schema Analyzer 分析Prisma模式以发现性能问题、关系设计问题、缺失索引、迁移风险和查询优化机会。审核schema.prisma以确保生产就绪并推荐改进。 使用方法 “分析我的Prisma模式以发现问题” “检查我的Prisma模式中缺失的索引” “审查Prisma关系以发现N+1风险” “审核迁移安全以确保我的模式更改安全” 工作原理

• 模式发现

cat prisma/schema.prisma 2>/dev/null find . -name "schema.prisma" 2>/dev/null 检查迁移 ls prisma/migrations/ 2>/dev/null | tail -10

• 模型分析

字段设计：每个字段的适当类型（String vs Int vs DateTime） 缺失@default值 @updateAt在需要更新跟踪的模型上 可选字段（？）应为必需字段 枚举使用与字符串固定值字段 JSON字段应使用结构化模型 ID策略：@id类型：autoincrement vs cuid vs uuid 复合键 UUID主键与整数主键的性能影响 命名约定：模型名称、字段名称、关系名称 @@map和@map用于数据库原生命名

• 索引策略

缺失外键字段索引 缺失where子句中使用的字段索引 复合索引用于多列查询（@@index） 唯一约束用于业务规则（@@unique） 全文索引用于搜索字段 索引用于时间基于查询的createdAt/updatedAt

• 关系分析

隐式多对多（Prisma自动创建连接表） 显式多对多用于额外关系字段 一对一关系：哪一方拥有外键 级联删除配置（onDelete：Cascade vs SetNull vs Restrict） 自关系（树结构、关注者） 关系加载模式（include vs select）

• 查询优化

审查Prisma Client在代码库中的使用 grep -rn "prisma\.\w\+\.find\|prisma\.\w\+\.create\|prisma\.\w\+\.update" src/ | head -30 grep -rn "include:" src/ | head -20 N+1查询：循环中个别findUnique 过度获取：findMany无select 缺失分页：findMany无take/skip 原始查询可以使用Prisma Client 事务用于多步操作

• 迁移安全

npx prisma migrate diff --from-schema-datamodel prisma/schema.prisma --to-schema-datasource prisma/schema.prisma --script 2>/dev/null 破坏性更改：删除列、重命名字段 锁定操作：新索引在大表上 数据迁移：类型更改、默认值添加 向后兼容性：旧代码可以运行在新模式下 输出

Prisma模式分析

模型： 14 | 关系： 22 | 索引： 8 | 枚举： 5

🔴 严重（2）

• 缺失索引在Order.userId — prisma/schema.prisma:45 userId String无@@index([userId])

订单表在每个页面加载时都有外键查询 → 添加@@index([userId])到Order模型

• 级联删除在User → Orders — prisma/schema.prisma:12 删除用户级联到所有订单（财务记录！）→ 更改为onDelete: Restrict或SetNull

🟡 改进（4）

• 缺失@updatedAt在8个模型
• 使用String代替status字段 — 使用枚举OrderStatus
• 隐式多对多Tag-Post — 添加显式多对多用于元数据
• 缺失复合索引在[userId, createdAt]（常见查询模式）

📊 模式指标

• 每个模型的平均字段数：8.2
• 有索引的模型：6/14（43%）
• 有显式级联的关系：4/22（18%）
• 可选字段：23（审查是否所有字段都真正可选）

✅ 良好实践

• cuid()用于所有主键（分布式安全）
• 枚举类型用于状态字段
• @map/@@用于Postgres命名约定
• 适当的DateTime字段与@default(now())