如何在Sequelize.js中查看SQL语句的执行计划？

嘿，我刚好折腾过这个问题——Sequelize确实没有MongoDB那种直接链式调用的.explain()，但有两种靠谱的方式能拿到PostgreSQL的执行计划，针对你给出的User.findOne查询，我给你拆解一下：

方法一：代码里直接生成并执行EXPLAIN查询 #

这种方式能让你在代码里直接获取执行计划，适合自动化分析或者调试：

// 第一步：让Sequelize生成查询对应的SQL和绑定参数
const queryObj = User.findOne({
  where: { id: req.params.id },
  include: { model: Post }
});
const { sql, bind } = queryObj.toSql();

// 第二步：给SQL加上EXPLAIN ANALYZE前缀（PostgreSQL推荐用这个，能拿到真实执行统计）
const explainSql = `EXPLAIN ANALYZE ${sql}`;

// 第三步：执行这条带EXPLAIN的查询
const executionPlan = await sequelize.query(explainSql, {
  bind, // 带上原查询的参数，避免SQL注入
  type: sequelize.QueryTypes.SELECT
});

// 打印执行计划，里面会有索引使用情况、扫描行数、执行时间等关键信息
console.log(JSON.stringify(executionPlan, null, 2));

这里的toSql()是Sequelize的核心方法，能把ORM查询转换成原始的SQL语句，再加上PostgreSQL的EXPLAIN ANALYZE指令，就能拿到和直接在数据库里执行一样的执行计划了。

方法二：通过日志快速获取SQL，手动在数据库里执行EXPLAIN #

如果你只是临时调试，不想改代码，也可以开启Sequelize的日志功能，拿到生成的SQL后去PostgreSQL客户端（比如psql、pgAdmin）里手动执行：

首先开启Sequelize的日志：

const sequelize = new Sequelize({
  // 你的数据库连接配置
  database: 'your_db',
  username: 'your_user',
  password: 'your_pwd',
  dialect: 'postgres',
  logging: console.log, // 把SQL打印到控制台
  benchmark: true // 可选，会显示查询执行时间
});

当你运行User.findOne查询时，控制台会输出类似这样的SQL：

SELECT "User".*, "Post".* FROM "Users" AS "User" LEFT OUTER JOIN "Posts" AS "Post" ON "User"."id" = "Post"."userId" WHERE "User"."id" = $1;

把这段SQL复制到PostgreSQL客户端，前面加上EXPLAIN ANALYZE执行：

EXPLAIN ANALYZE SELECT "User".*, "Post".* FROM "Users" AS "User" LEFT OUTER JOIN "Posts" AS "Post" ON "User"."id" = "Post"."userId" WHERE "User"."id" = 123; -- 把$1换成实际的ID值

这样就能看到完整的执行计划了，适合快速验证索引是否生效这类场景。

小提示 #

• EXPLAIN和EXPLAIN ANALYZE的区别：前者只生成执行计划不实际执行查询，后者会真实执行并返回执行时间、扫描行数等统计数据，优化查询时后者更有用。
• 如果你用的是Sequelize v6或者更高版本，toSql()的用法完全一致，没有版本兼容问题。
• 对于复杂的关联查询，第一种方法能确保参数正确传递，避免手动替换参数出错。

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