使用sequelize-cli迁移后遇Column not found及UserId未知字段问题

一、列不存在（column does not exists/errorMissingColumn）问题排查 #

• 确认迁移是否成功执行
  执行命令 sequelize db:migrate:status，查看目标迁移文件的状态是否为up。若显示down，说明迁移未生效，重新运行sequelize db:migrate并检查控制台是否有执行报错。
• 核对模型与迁移文件的字段一致性
  确保模型（Model）中定义的字段名和迁移文件（Migration）里的列名完全匹配，注意大小写敏感（如PostgreSQL对大小写严格，迁移文件用双引号定义的列名，模型需对应）。例如迁移文件写user_id，模型不能写成userId，除非全局或模型配置了underscored: true。
• 检查数据库实际表结构
  直接通过数据库命令行或可视化工具查看目标表的列，确认迁移是否真的创建了所需字段。有时迁移文件语法错误（如字段类型写错）会导致迁移执行但未创建目标列。
• 清除缓存并重启服务
  Sequelize可能缓存模型结构，修改模型或迁移后，务必重启Node.js服务，避免缓存引发的字段不匹配问题。

二、未知字段UserId出现的原因及解决 #

• 关联配置自动生成外键
  当模型间配置了belongsTo、hasMany这类关联时，Sequelize默认会自动生成外键。比如Model A关联Model B时，默认会在Model A的表中添加UserId字段（若Model B主键为id）。如果迁移文件未手动定义该外键，就会出现表中无此字段但Sequelize尝试调用的情况。
  解决方式：
  1. 在关联配置时显式指定外键，示例代码：

     // 模型关联代码
     User.belongsTo(Role, { foreignKey: 'role_id' });
     

     同时在迁移文件中添加role_id列的定义。
  2. 若不需要该外键，检查模型是否误配置了不必要的关联，移除错误关联即可。
• 模型underscored配置不一致
  若模型设置了underscored: true，Sequelize会自动将驼峰字段转为下划线格式，但如果关联时未同步此配置，会出现UserId（驼峰）与表中实际user_id（下划线）不匹配的情况。确保所有模型underscored配置统一，或在关联时明确指定外键名称。

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