Sequelize(ORM)实例方法引用其他模型何时需加sequelize.前缀？

两种写法没有绝对的对错，核心差异是模型的获取路径不同，具体用哪个完全取决于你项目的模型初始化、导出逻辑。

两种写法的本质区别 #

• 选项1（直接调用require引入的Admins）：拿到的是通过模块系统单独引入的、已经完成初始化的Admins模型类
• 选项2（调用sequelize.Admins）：是从Sequelize实例内置的模型缓存池中，取已经注册完成的Admins模型，不需要在当前文件单独写require引入

不需要加sequelize.前缀的场景 #

满足以下所有条件时，可以直接用require引入模型调用，不需要加前缀：

• 项目只有一个Sequelize数据库实例，且每个模型文件在定义完成后，直接导出了绑定好当前实例的完整模型类
  典型的可直接引入的模型文件写法如下：

  // admin.js
  const { DataTypes } = require('sequelize')
  const sequelize = require('../config/db') // 提前初始化好的单例sequelize
  const Admins = sequelize.define('Admins', {
    organization_id: DataTypes.INTEGER
    // 其余字段定义
  })
  module.exports = Admins
  

• 确认当前模型和你引入的Admins模型绑定的是同一个数据库实例，不会出现跨连数据库的问题
• 两个模型之间不存在双向引用（也就是Admins文件不会反过来require当前的Organization模型），不会触发Node.js的循环引用报错

这种写法的缺点很明显：一旦模型之间有双向关联需要互相引用，很容易因为Node模块的加载机制拿到未初始化的空对象，运行直接报错。

需要加sequelize.前缀的场景 #

只要符合以下任意一种情况，就应该用带sequelize.前缀的写法：

• 项目做了模型统一注册封装：所有模型定义完成后都批量挂载到sequelize实例上，模型文件本身只导出定义函数，不直接导出初始化完成的模型
  常见的统一注册逻辑如下：

  // db.js 数据库初始化入口
  const Sequelize = require('sequelize')
  const sequelize = new Sequelize(/* 数据库连接配置 */)
  const fs = require('fs')
  const path = require('path')
  // 批量加载models目录下的所有模型并注册
  fs.readdirSync(path.join(__dirname, 'models'))
    .filter(file => file.endsWith('.js'))
    .forEach(file => {
      const defineModel = require(path.join(__dirname, 'models', file))
      const model = defineModel(sequelize, Sequelize.DataTypes)
      sequelize[model.name] = model
    })
  // 统一建立模型间关联
  Object.keys(sequelize.models).forEach(modelName => {
    if (sequelize[modelName].associate) {
      sequelize[modelName].associate(sequelize.models)
    }
  })
  module.exports = sequelize
  

  这种结构下根本不需要在每个模型文件里单独require其他模型，直接从sequelize实例上取就行，从根源避免循环引用问题。
• 项目存在多个Sequelize实例（比如同时连接业务库、日志库多个数据库）：单独require很容易拿错绑定了其他库的模型，从当前实例上取模型能100%保证同实例操作，不会出现跨库报错。
• 模型之间存在双向关联、容易触发循环引用：这种写法不需要在文件顶部互相加载模型文件，完全绕开Node模块循环加载的坑。

补充个实用细节：在Sequelize的实例方法里，不需要额外全局引入sequelize实例，直接通过this.sequelize就能拿到当前模型绑定的实例，比手动全局引入更可靠，不会出现实例不匹配的问题，对应写法是：

Organization.prototype.getAdmins = function () {
  return this.sequelize.models.Admins.findAll({
    where: { organization_id: this.getDataValue("id") }
  })
}

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