Sequelize sync在alter设为false时仍执行ALTER类查询问题

可能的原因及排查方向 #

• 存在其他带alter/force参数的sync调用：检查项目中是否有其他地方调用了sequelize.sync({ alter: true })或单个模型的model.sync({ alter: true })，单个模型的sync配置会覆盖全局设置。
• Sequelize版本bug：部分旧版本的Sequelize存在sync参数识别错误的问题，可尝试升级到最新稳定版，或核对对应版本官方文档确认sync的预期行为。
• 模型结构缓存未更新：Sequelize会缓存模型定义，若修改模型代码后未重启服务，缓存的旧结构和数据库表实际结构冲突，可能触发意外ALTER操作，重启服务重新加载模型即可验证。
• 数据库元数据读取异常：如果数据库用户缺少查询information_schema的权限，Sequelize无法正确读取表结构元数据，可能误判结构不匹配从而执行ALTER语句，检查用户权限是否足够。
• 第三方插件或钩子干扰：排查是否使用了自动迁移类插件，或自定义了模型钩子，这些逻辑可能在sync后自动执行ALTER操作。

验证步骤 #

1. 全局搜索项目中所有sync(调用，确认是否存在其他非预期的配置。
2. 打印当前Sequelize版本确认是否存在版本兼容问题：

console.log('Sequelize版本:', sequelize.version);

3. 手动核对模型定义与数据库表结构的一致性，包括列名、数据类型、约束等细节。
4. 临时移除自定义钩子和第三方插件，重新运行代码观察是否仍执行ALTER语句。
5. 可在sync前打印配置确认参数是否生效：

console.log('当前sync配置:', { alter: false, force: false });
await sequelize.sync({ alter: false, force: false });

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