MySQL种子表缺失groupLetter列，世界杯预测应用生产环境异常

核心排查方向 #

1. 确认Prisma Client与Schema的同步性 #

• 本地修改Schema后，必须执行prisma generate更新Prisma Client，生产环境部署时务必同步执行该命令。如果生产环境使用旧版Client，会直接导致无法识别groupLetter字段，查询、插入操作都会出错。
• 对比本地与生产环境的@prisma/client版本：本地执行npm list @prisma/client，生产环境执行相同命令，确保版本完全一致。

2. 检查PlanetScale的Schema同步状态 #

• 登录PlanetScale控制台，查看生产分支的Game表结构，确认groupLetter列是否存在。若不存在，说明Schema推送未生效：
  • 确认推送Schema时使用的是生产分支，而非开发分支；
  • 若用分支模式，需将包含groupLetter字段的Schema分支Promote到生产分支，确保生产环境用的是最新Schema；
  • 检查生产环境中prisma db push的执行日志，看是否有Schema变更失败的报错（比如字段约束冲突、权限不足等）。

3. 验证种子数据的执行顺序 #

• 生产环境部署时，必须保证先推送Schema，再执行seed脚本。如果先跑seed再更新Schema，插入数据时表结构还没groupLetter字段，自然无法写入该字段。
• 检查部署流程的脚本顺序，确认prisma db push（或prisma migrate deploy）在node seed.js之前执行。

4. 确认数据库连接配置 #

• 检查生产环境的数据库连接字符串，确保指向的是已更新Schema的PlanetScale生产分支，而非旧数据库实例或开发分支。

应急验证步骤 #

1. 在PlanetScale生产分支的Game表中手动添加groupLetter列（匹配Schema定义的类型与约束）；
2. 重新执行生产环境的seed脚本，查看数据是否成功写入groupLetter字段；
3. 执行分组查询，验证PrismaClientValidationError是否消失。

内容的提问来源于stack exchange，提问作者Marcelo Franco