Prisma Schema 评审原则
0 项精确优先于召回:仅报告在变更的 schema 及其可达的应用、迁移与数据源上下文中很可能真实存在的缺陷。将数据丢失、完整性、安全与兼容性类发现视为阻塞项;仅涉及风格的建议为非阻塞项。不要重复报告prisma validate、prisma format、迁移工具或数据库能够机械判定的错误,除非 diff 揭示了具体的生产后果。
在报告非局部结论之前,使用 file_read 与 code_search 检查数据源 provider、Prisma 版本、迁移历史、生成客户端的调用点、查询以及既有 schema 约定。在没有数据库 provider、已部署数据或受影响应用行为的证据时,不要假定某个关系操作、索引、原生类型、字段或生成器设置不安全。
关系与引用完整性
5 项- 关系字段的可空性、标量外键字段、
fields或references声明彼此不一致,允许无效或无法表达的关系。先确认该关系位于关系型数据库还是 MongoDB,以及受影响字段是否确实被修改内置来源与改动说明
onDelete或onUpdate操作可能意外删除数据、置空数据或产生孤儿数据;在必选关系上使用SetNull;级联形成破坏性路径或环;或配置的 provider 不支持某项操作。仅在掌握受影响数据归属与删除/更新流程的证据时才报告内置来源与改动说明
- 相同模型间的多重关系存在歧义,缺少绑定预期字段所需的关系名称,或关系名称只在单侧变更内置
来源与改动说明
relationMode变更移除了数据库强制的外键,或将完整性强制转移到 Prisma 而没有相应的应用防护。不要报告为应对有文档记载的数据库限制而有意使用的模式内置来源与改动说明
- 在需要显式连接模型承载关系元数据、引用操作、payload 字段或稳定数据库映射之处,变更了隐式多对多关系内置
来源与改动说明
Schema 演进与数据兼容性
5 项- 移除、重命名、收窄、改为必选或改变模型、字段、枚举值、标识符、唯一约束、映射、原生类型或默认值的语义,可能丢失既有数据、导致迁移失败或破坏已部署的客户端代码。标记前先检查迁移与调用点内置
来源与改动说明
- 新增非空字段却没有针对既有行的安全回填/默认值/迁移策略;变更默认值导致新记录行为改变;或使用与 Prisma/客户端预期不符的数据库默认值内置
来源与改动说明
- 变更
@id、@@id、@unique、@@unique、@map或@@map,改变了标识、upsert/connect 选择器、生成的客户端名称、既有数据库列/表名称或外部存储的引用内置来源与改动说明
- 移除或重命名既有行、迁移或应用代码仍可能使用的枚举值。除非 provider/应用兼容性确立了真实风险,否则不要标记新增的枚举值内置
来源与改动说明
- 原生数据库类型、
@db.*属性以及 provider 特有特性,与配置的 provider、已部署的数据库版本、既有值、精度/标度、长度或时区语义不兼容内置来源与改动说明
索引、约束与查询行为
4 项- 仅当应用查询、关系查找、唯一性保证或迁移行为表明存在具体需求时,才报告缺失、被移除或顺序错误的
@@index、@@unique或复合约束。不要仅凭字段名称或假想的规模来要求索引内置来源与改动说明
- 对既有数据新增唯一约束却缺少去重/迁移路径,或在调用方依赖唯一性保障认证、租户隔离、幂等性、
connect或upsert时将其移除内置来源与改动说明
- 复合索引/唯一约束与变更后的相等、排序或关系访问模式不匹配,产生不可用的选择器或本可避免的生产查询退化内置
来源与改动说明
- 变更全文、部分、聚簇、排序、operator-class 或其他 provider 特有的索引选项,而配置的 provider/版本不支持这些选项,或这些选项改变了正确性语义内置
来源与改动说明
数据源、生成器与部署安全
4 项- 在 schema 或相关 Prisma 配置中硬编码数据库 URL、凭据、token 或连接参数,可能导致其被提交、记录日志或部署到错误环境。优先使用基于环境的配置,并确认该值确属机密而非安全的本地/测试 URL内置
来源与改动说明
- 数据源 provider、schema、扩展、shadow-database、直连或连接池变更与目标环境或迁移工作流不兼容。先检查 Prisma 配置与部署设置内置
来源与改动说明
- 生成器 provider、输出、binary-target、engine、preview-feature 或客户端生成变更,可能破坏构建、运行时部署目标、生成的导入或 CI。不要仅因某个生成器设置与默认值不同就标记内置
来源与改动说明
- 在没有兼容性证据的情况下启用、移除或变更 preview 或实验特性;确保项目的 Prisma 版本支持所配置的特性内置
来源与改动说明
安全与敏感数据
3 项- 模型或字段通过生成的客户端、日志、管理工具或过宽的关系,新暴露了机密、凭据、访问 token、密码哈希、私钥、财务数据或个人数据。确认字段的实际用途与访问边界内置
来源与改动说明
- 仅当代码与 schema 共同表明可能存在跨租户访问、重复身份或授权绕过时,才报告缺失的租户/所有者关系、唯一性或完整性约束。不要从泛化的模型名称推断授权要求内置
来源与改动说明
- 不安全的默认值、级联、映射或可空的所有权字段,使破坏性操作跨越既定的租户或授权边界内置
来源与改动说明
评审范围
3 项- 聚焦于正确性、完整性、迁移安全、有查询证据支撑的性能、安全与部署兼容性内置
来源与改动说明
- 不要将格式化、模型/字段命名偏好、关系命名风格、文档请求或推测性索引报告为发现内置
来源与改动说明
- 当 schema 变更有意伴随迁移、生成客户端更新或应用代码变更时,报告兼容性问题前先评审完整变更集内置
来源与改动说明