Sequelize生成的查询在DBeaver可用但程序返回null问题排查

可能原因 #

1. 字段映射不匹配 #

代码中使用sequelize.col('emp_id')，但生成的SQL里却是user_id，说明UserActivity模型的字段映射存在偏差：要么模型里emp_id属性通过field配置映射到了数据库的user_id字段，要么你混淆了模型属性名和数据库实际字段名，导致查询条件指向了错误的字段。

2. 时区不一致导致日期匹配失效 #

数据库中activity_date是带时区的（如2022-11-05 00:00:00.000 +0530），而你用moment(dateNow).format('YYYY-MM-DD')生成的是本地时区的日期字符串。如果程序运行时区与数据库时区（+0530）不一致，会导致date(activity_date)在数据库中的值和程序生成的currentDate不匹配，从而查不到数据。

3. 循环异步执行逻辑错误 #

如果你的循环是用forEach实现的，await db.UserActivity.findAll()不会等待上一次查询完成就进入下一次循环，可能导致emp.id被覆盖，查询使用了错误的员工ID，最终返回空结果。

4. 软删除隐式过滤问题 #

如果UserActivity模型开启了paranoid（软删除）模式，Sequelize会自动添加deletedAt IS NULL的过滤条件。若数据库中目标数据的deletedAt字段非空，会被过滤掉，但这条可能性较低（因为你在DBeaver执行SQL能得到结果）。

解决方法 #

1. 修正字段引用方式 #

优先使用模型属性名构建查询，避免直接操作数据库字段名：

// 假设模型中对应员工ID的属性是empId
whereClauseArr1.push({ empId: emp.id });

如果必须使用sequelize.where，确保引用数据库实际字段名并加上表前缀：

// 数据库字段为emp_id时
whereClauseArr1.push(
  db.sequelize.where(
    db.sequelize.col('user_activities.emp_id'), 
    '=', 
    emp.id
  )
);

2. 统一时区处理 #

放弃手动格式化日期字符串，让Sequelize自动处理时区：

• 方式一：用数据库函数统一时区计算

whereClauseArr1.push(
  db.sequelize.where(
    db.sequelize.fn('date', db.sequelize.col('activity_date'), '+05:30'),
    '=',
    db.sequelize.fn('date', db.sequelize.fn('now'), '+05:30')
  )
);

• 方式二：用日期范围查询，传递Date对象

const startOfDay = moment(dateNow).startOf('day').toDate();
const endOfDay = moment(dateNow).endOf('day').toDate();
whereClauseArr1.push({
  activity_date: {
    [db.Sequelize.Op.between]: [startOfDay, endOfDay]
  }
});

同时确保Sequelize配置的时区与数据库一致：

const sequelize = new Sequelize(dbName, user, pass, {
  // 其他配置
  timezone: '+05:30' // 和数据库时区匹配
});

3. 修复循环异步逻辑 #

将forEach循环改为for...of，确保每次查询等待完成：

// 假设员工数组为emps
for (const emp of emps) {
  let whereClauseArr1 = []; 
  const startOfDay = moment(dateNow).startOf('day').toDate();
  const endOfDay = moment(dateNow).endOf('day').toDate();
  whereClauseArr1.push({
    activity_date: { [db.Sequelize.Op.between]: [startOfDay, endOfDay] },
    empId: emp.id
  });
  const empData = await db.UserActivity.findAll({ where: whereClauseArr1 });
  // 处理empData
}

4. 验证软删除过滤（可选） #

临时关闭软删除过滤来排查问题：

const empData = await db.UserActivity.findAll({ 
  where: whereClauseArr1,
  paranoid: false // 关闭软删除自动过滤
});

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