prisma-expert

Prisma Expert - Prisma ORM 专家助手

技能概述

Prisma Expert 是专注于 Prisma ORM 的专家助手，提供 schema 设计、迁移管理、查询优化、关系建模和数据库操作的全方位支持。

适用场景

1. Schema 设计与关系建模

当你需要设计或优化 Prisma schema 时，包括定义模型关系（一对一、一对多、多对多）、添加索引、配置级联行为，或解决关系定义导致的运行时错误。

2. 迁移问题与部署

处理 Prisma 迁移过程中的各种问题，如迁移冲突、失败回滚、生产环境部署，以及多人协作时的迁移文件管理。

3. 查询性能优化

解决 N+1 查询问题、优化慢查询、配置连接池、管理 Serverless 环境下的数据库连接，以及实现高效的事务处理。

核心功能

1. 渐进式问题修复

提供 minimal → better → complete 三层修复策略，从快速修复最小可行方案到完整架构优化，根据你的需求选择合适的解决深度。

2. 诊断命令与最佳实践

内置诊断命令帮助快速定位问题，同时提供 Prisma 官方最佳实践指导，包括 schema 规范、查询模式和迁移安全流程。

3. 多数据库支持

涵盖 PostgreSQL、MySQL、SQLite 等主流数据库的 Prisma 使用场景，并提供针对性的优化建议。

常见问题

Prisma migration 失败如何回滚？

如果在开发环境中迁移失败，可以使用 npx prisma migrate reset 重置数据库。在生产环境中，如果迁移已部分应用，使用 npx prisma migrate resolve --rolled-back "migration_name" 标记迁移状态。切记生产环境永远不要使用 migrate dev。

Prisma 如何解决 N+1 查询问题？

使用 include 预加载关联数据，或使用 select 只查询需要的字段。对于复杂聚合查询，考虑使用 $queryRaw 执行原生 SQL。关键是在查询前识别关系依赖，避免在循环中执行查询。

Prisma schema 关系定义报错怎么办？

确保 @relation 指令正确配置 fields 和 references 参数，显式命名关系以避免歧义。检查外键字段类型是否与引用的主键类型一致，并定义适当的 onDelete 和 onUpdate 级联行为。

Prisma 在生产环境如何部署迁移？

生产环境必须使用 npx prisma migrate deploy 而非 migrate dev。部署前应在测试环境验证迁移脚本，确保向后兼容且无数据丢失风险。建议为关键迁移准备回滚策略。