TypeORM报QueryFailedError列数与值不匹配错误该如何排查？

这个报错本质是SQL执行时，插入语句指定的列数量和传入的值数量不匹配，你已经验证过synchronize生效、表结构自动重建无效，大概率是代码逻辑层面的问题，常见原因如下：

• 自定义写入SQL不匹配：如果是用EntityManager.query()、QueryBuilder自行拼接插入语句，手动写的列列表和传入的参数数量不一致，这类场景synchronize不会生效，框架不会校验你手写SQL的正确性
• 实体类字段配置和传入数据不匹配：
  • 实体类存在非自动生成、无默认值的必填字段，写入时漏传对应值
  • 写入时多传了实体类中没有用@Column声明的冗余字段，部分版本TypeORM会尝试将冗余字段也加入插入列列表
  • 自动生成字段（@CreateDateColumn、@UpdateDateColumn、@Generated修饰的字段）被强制手动传值，导致SQL生成逻辑异常
• 关系字段配置错误：@ManyToOne等关系字段写入时传入了完整关联对象而非关联字段值，导致框架生成插入语句时额外添加了不存在的列
• 实体映射配置错误：使用@Column({name: 自定义列名})时列名配置重复，或者驼峰下划线转换插件配置异常，导致单个实体字段被映射为多个数据库列
• 多数据源/环境配置错误：你删除表的数据库和当前代码实际连接的数据库不是同一个，比如配置加载错误连到了测试库/生产库，synchronize没有作用到实际运行的库
• 实体继承逻辑异常：实体类继承的父类BaseEntity、或混入的类中存在未声明的额外字段，或者重复定义了同名字段，导致实际生成的列数超出预期
• 生命周期钩子逻辑异常：@BeforeInsert等写入前钩子中错误添加/删除了实体字段，导致最终生成的插入列和值数量不匹配

• 第一步开启SQL日志：在ormconfig中添加logging: true配置，重启项目后复现写入操作，直接打印出实际执行的插入SQL，对比SQL中INTO后面的列列表和VALUES后面的值列表，能直接定位是多了列还是少了值
• 核对写入代码逻辑：如果用Repository.save()方法写入，核对传入的对象属性和实体类@Column声明的字段是否完全匹配，去掉冗余字段，补全无默认值的必填字段；如果是手写SQL，直接核对列数和参数数量是否一致
• 核对实际表结构：手动执行SQL查看表结构，比如MySQL执行DESC 你的表名，确认实际表的字段数量、字段名和实体类配置完全一致
• 验证数据库连接配置：打印当前运行环境的数据库连接参数（主机、端口、库名），确认和你操作的数据库是同一个，排除配置加载错误问题
• 排查实体类继承、钩子逻辑：注释掉父类继承、生命周期钩子后重试，排查是否是这类扩展逻辑导致的字段异常

内容的提问来源于stack exchange，提问作者Joel Imbergamo