Sequelize模型关联报错：Users.hasMany传入非Model子类及关联缺失问题

问题概述 #

在使用Sequelize关联Users与Comments模型时遇到两个典型错误：

• 调用Users.hasMany时触发："Users.hasMany called with something that's not a subclass of Sequelize.Model."
• 移除Comments模型中的跨文件引用及belongsTo配置后，出现："Users is not associated to Comments!"错误

需求是查询所有评论时关联Users表，获取评论创建者的用户名。

核心原因与解决步骤 #

1. 循环引用导致模型未初始化 #

当前代码存在循环引用问题：Users模型引入Comments，Comments模型反向引入Users，导致其中一个模型在被require时还未完成Sequelize.Model的初始化，因此触发"不是Model子类"的错误。

解决方法：统一管理关联配置

不要在模型文件内部互相引用，而是将关联配置抽离到单独文件，利用Sequelize的模型注册表来获取已加载的模型：

步骤1：创建关联初始化文件

新建associations.js，集中配置所有模型关联：

const { sequelize } = require('./');
// 从Sequelize实例的模型注册表中获取已定义的模型
const Users = sequelize.models.Users;
const Comments = sequelize.models.Comments;

// 一对多关联配置
Users.hasMany(Comments, {
    foreignKey: "userId",
    onDelete: "cascade",
});

Comments.belongsTo(Users, {
    foreignKey: "userId",
    onDelete: "cascade",
});

步骤2：修改模型文件，移除循环引用

• Comments模型（移除对Users的require）：

const { DataTypes } = require("sequelize");
const { sequelize } = require(".");

const Comments = sequelize.define("Comments", {
    comment: {
        type: DataTypes.STRING,
        allowNull: false,
        validate: {
            min: 1,
            max: 50,
        },
    },
});

module.exports = Comments;

• Users模型（移除对Comments的require）：

const { DataTypes } = require("sequelize");
const { sequelize } = require(".");
const jwt = require("jsonwebtoken");

const Users = sequelize.define("Users", {
    username: {
        type: DataTypes.STRING,
        allowNull: false,
        unique: true,
        validate: {
            min: 5,
            max: 30,
            notNull: true,
        },
    },
});

module.exports = Users;

步骤3：在项目启动时加载模型与关联

在项目入口文件（如app.js）中，先加载所有模型，再初始化关联：

// 先加载所有模型定义
require('./user');
require('./comment');
// 再初始化模型关联
require('./associations');

2. 修正查询时的关联引用 #

修改查询代码，使用模型名称字符串（或从Sequelize注册表获取模型）来避免变量引用问题：

const getComments = async (req, res) => {
    const comments = await Comments.findAll({
        include: 'Users', // 或使用 sequelize.models.Users
    });
    res.send(comments);
};

额外检查项 #

• 确保数据库的Comments表中存在userId字段，若不存在，可通过sequelize.sync({ alter: true })或迁移文件添加该字段。
• 关联配置中的foreignKey必须与数据库字段名完全一致。

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