Prisma执行db pull后带@map的数字列映射字段被注释问题

问题分析 #

你的场景里，MySQL表使用纯数字列名（1、2、3...），通过Prisma模型的@map注解映射为合法的模型字段名（one、two...）后，生成的Client查询正常，但执行prisma db pull时，这些映射字段会被自动注释，终端同时输出已读取@map信息和字段名不支持的矛盾提示。核心原因是：

• Prisma运行时（Client）完全支持@map映射到纯数字列，所以查询逻辑能正常工作；
• 但db pull的反向工程工具会严格校验模型字段命名规则（不允许纯数字或数字开头的字段名），误将你手动配置的映射字段判定为无效，从而自动注释，同时又能识别到数据库中的纯数字列，导致输出矛盾信息。

可行解决方案 #

1. 手动维护映射字段（优先推荐，无需修改数据库） #

执行prisma db pull后，手动取消被注释的映射字段行，保留@map注解即可。因为Client运行时完全兼容这种映射配置，只要手动恢复字段定义，就能继续正常使用。

2. 修改数据库列名（彻底解决，若允许操作数据库） #

如果业务允许，给MySQL的纯数字列添加前缀（比如col_1、col_2），这样Prisma可以直接识别列名并生成合法的模型字段，无需依赖@map映射，从根源避免工具层面的校验问题。

3. 自定义schema修复脚本（进阶自动化方案） #

编写简单的Node脚本，在db pull后自动恢复被注释的映射字段。步骤如下：

1. 创建脚本文件（比如./scripts/fix-schema.js）：

const fs = require('fs');
const schemaPath = './prisma/schema.prisma';

let schemaContent = fs.readFileSync(schemaPath, 'utf8');
// 匹配被注释的映射字段并恢复
schemaContent = schemaContent.replace(/\/\/ (\w+)\s+(\w+)\??\s+@map\("(\d+)"\)/g, '$1          $2$3   @map("$3")');
fs.writeFileSync(schemaPath, schemaContent);

2. 在package.json中添加钩子脚本：

{
  "scripts": {
    "postdb:pull": "node ./scripts/fix-schema.js"
  }
}

之后执行npm run db:pull时，会自动触发脚本修复被注释的字段。

注意事项 #

• 版本降级、重装依赖等操作无法解决该问题，因为这是Prismadb pull工具的校验逻辑特性，而非依赖或版本BUG；
• 手动维护时建议备份schema文件，避免db pull覆盖重要配置。

内容的提问来源于stack exchange，提问作者Nishant Joshi