Sequelize findAll生成有效查询却返回空数组问题排查

以下是逐步排查的关键点：

• 检查关联的连接类型
  如果你需要保留composeID为NULL的记录，关联User表时必须确保是左外连接，而非Sequelize默认的内连接。在include选项里显式设置required: false，示例代码：

  Interactions.findAll({
    attributes: ['composeID'],
    include: [{
      model: User,
      where: { id: 指定用户ID },
      required: false // 关键：改为左外连接，保留无关联的记录
    }]
  })
  

  因为belongsTo关联默认required: true（内连接），会过滤掉没有匹配User的记录，这会导致应用端返回空数组，但手动执行左连接SQL能拿到包含NULL的结果。

• 核对查询参数的类型匹配
  确认传入的用户ID和数据库User表id字段的类型完全一致：比如数据库id是INT类型，你却传入了字符串ID；或者数据库是UUID字符串，你传入了数字。这种类型不匹配会让Sequelize参数绑定后查询无结果，但手动替换参数时数据库会隐式转换，所以能查到数据。

• 验证模型与数据库的映射一致性

  • 检查Interactions模型中composeID字段是否设置了allowNull: true，如果模型里设为allowNull: false，Sequelize会自动过滤NULL值的记录。
  • 确认模型的tableName是否和数据库实际表名一致，避免Sequelize查询了错误的表（比如默认复数化导致interactions和Interaction表名差异）。

• 对比生成SQL与手动执行SQL的差异
  开启Sequelize日志功能（初始化时设置logging: console.log），把控制台输出的完整SQL（含参数绑定值）复制出来，和手动执行的SQL逐字对比：

  • 检查WHERE条件是否正确，有无多添或少加过滤规则
  • 确认关联的表别名、字段名是否和数据库一致
  • 验证参数值是否正确传入，比如有没有把undefined或错误ID传到查询中

• 排查全局作用域或钩子的影响
  查看模型是否设置了全局默认作用域（defaultScope），或者存在beforeFind这类钩子，它们可能自动添加额外过滤条件，导致结果被过滤为空。

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