Sequelize中findOne传参报错，附路由代码求解决方案

这个错误我太熟了！问题出在你对Sequelize的findOne()方法用法理解错了——它不能直接接收单个主键值，必须传一个包含查询配置的options对象；如果只是根据主键查询，官方推荐用findByPk()（或者旧版本的findById()）。

错误原因分析 #

Sequelize抛出的错误提示已经说得很明确：

传递给findOne的参数必须是一个options对象，若要传递单个主键值请使用findById。

也就是说，如果你写了类似models.YourModel.findOne(123)这种直接传主键值的代码，就会触发这个错误。

两种正确的解决方式 #

结合你的Express路由场景，给你两种可行的修正方案：

方案1：使用findByPk()（推荐，Sequelize v5+版本）

findByPk()是专门用来根据主键查询单条数据的方法，可以直接接收主键值：

router.get('/your-route/:id', async (req, res) => {
  try {
    // 直接传入主键值即可
    const data = await models.YourModel.findByPk(req.params.id);
    res.json(data);
  } catch (err) {
    res.status(500).json({ error: err.message });
  }
});

如果你的Sequelize版本比较旧，也可以用findById()，功能和findByPk()一致。

方案2：给findOne()传入options对象

如果你一定要用findOne()（比如查询条件不只是主键），必须把查询条件放在where属性里，传入一个完整的options对象：

router.get('/your-route/:id', async (req, res) => {
  try {
    const data = await models.YourModel.findOne({
      where: { id: req.params.id } // 把主键值放在where对象中
    });
    res.json(data);
  } catch (err) {
    res.status(500).json({ error: err.message });
  }
});

这种方式也适用于更复杂的查询，比如根据其他字段筛选：

// 根据用户名和状态查询用户
const user = await models.User.findOne({
  where: { username: 'john_doe', status: 'active' }
});

额外提示 #

• 建议优先使用findByPk()处理主键查询，代码更简洁，也符合Sequelize的设计规范；
• 如果你用的是Sequelize v6+版本，findById()已经被标记为废弃，官方推荐用findByPk()替代。

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