Sequelize findOne返回null但手动执行对应SQL有结果的排查与解决

使用Sequelize作为ORM、PostgreSQL作为数据库，查询最新记录时返回null。通过logging参数输出执行的SQL语句，复制到psql手动执行却能正常返回预期记录。

相关Sequelize代码：

await db.log.findOne({
  where: {
    card_id: member.card_id,
    createdAt: {
      [Op.and]: [
        {
          [Op.gte]: db.sequelize.literal(`CURRENT_DATE + INTERVAL '${currentCourse.start_time.split(":")[0]} hours'`),
        },
        {
          [Op.lt]: db.sequelize.literal(`CURRENT_DATE + INTERVAL '1 day'`),
        }
      ]
    }
  },
  order: [['createdAt', 'DESC']],
  logging: console.log
});

执行的SQL语句：

SELECT "id", "card_id", "login_device", "entrance_type", "logout_device", "login", "logout", "amount", "facility_id", "uuid", "createdAt", "updatedAt" FROM "logs" AS "log" WHERE "log"."card_id" = '18af351e-843b-4e46-8734-75119057a417' AND ("log"."createdAt" >= CURRENT_DATE + INTERVAL '11 hours' AND "log"."createdAt" < CURRENT_DATE + INTERVAL '1 day') ORDER BY "log"."createdAt" DESC LIMIT 1;

可能的原因 #

• 时区不匹配：Sequelize默认使用UTC时区，若PostgreSQL或psql客户端使用本地时区，CURRENT_DATE的取值会存在差异，导致Sequelize执行时的时间过滤范围和手动执行时不一致。
• 动态值拼接异常：日志显示的SQL看似正确，但实际执行时currentCourse.start_time.split(":")[0]的取值可能不符合预期（比如空值、格式错误），只是日志输出时刚好显示正确数值。
• 日期映射问题：查询结果的createdAt字段在Sequelize映射为JS Date对象时出现异常，导致无法正常返回记录（此情况概率较低）。

解决方法 #

1. 统一时区配置 #

确保Sequelize与PostgreSQL使用相同时区：

• Sequelize初始化时指定时区：

const sequelize = new Sequelize('database', 'username', 'password', {
  // 其他配置项
  timezone: '+08:00', // 替换为你的实际时区，如东八区
  dialectOptions: {
    timezone: '+08:00'
  }
});

• 检查并同步PostgreSQL时区：

-- 查看当前数据库时区
SHOW TIMEZONE;
-- 修改数据库时区（需对应权限）
ALTER DATABASE your_db_name SET TIMEZONE = 'Asia/Shanghai';

2. 安全构建时间表达式，避免字符串拼接 #

改用参数绑定或Sequelize内置函数构建时间条件，避免手动拼接字符串的潜在风险：

// 先解析小时数并验证
const hour = parseInt(currentCourse.start_time.split(":")[0], 10);
if (isNaN(hour)) {
  // 处理无效小时数的情况
  throw new Error('Invalid start time format');
}

await db.log.findOne({
  where: {
    card_id: member.card_id,
    createdAt: {
      [Op.gte]: db.sequelize.literal(`CURRENT_DATE + INTERVAL '? hours'`, hour),
      [Op.lt]: db.sequelize.literal(`CURRENT_DATE + INTERVAL '1 day'`)
    }
  },
  order: [['createdAt', 'DESC']],
  logging: console.log
});

或者使用fn函数更规范地构建时间：

const hour = parseInt(currentCourse.start_time.split(":")[0], 10);
await db.log.findOne({
  where: {
    card_id: member.card_id,
    createdAt: {
      [Op.gte]: db.sequelize.fn('date_add', db.sequelize.fn('current_date'), db.sequelize.fn('interval', hour, 'hour')),
      [Op.lt]: db.sequelize.fn('date_add', db.sequelize.fn('current_date'), db.sequelize.fn('interval', 1, 'day'))
    }
  },
  order: [['createdAt', 'DESC']],
  logging: console.log
});

3. 验证动态参数的正确性 #

在查询前打印关键参数，确认取值符合预期：

console.log('当前课程开始时间:', currentCourse.start_time);
const hourPart = currentCourse.start_time.split(":")[0];
console.log('提取的小时数:', hourPart);
// 再执行查询逻辑

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