Discord.js+Sequelize跨文件调用数据库模型报错求助

问题根源 #

你当前的写法中，Tags模型仅在index.js的局部作用域内定义，ready.js无法直接访问；而直接require('index.js')会触发循环引用（index.js已加载ready.js，ready.js又反向加载index.js），导致模型未被正确初始化，出现Cannot read properties of undefined错误。

正确解决方案：抽离数据库与模型为独立模块 #

将数据库配置、Sequelize实例、模型定义全部放到单独文件中，让其他模块可以安全引用，避免作用域和循环引用问题。

步骤1：创建独立的数据库模块文件（db.js） #

在项目根目录新建db.js，把数据库初始化和模型定义移到这里：

const Sequelize = require('sequelize');

// 初始化Sequelize实例
const sequelize = new Sequelize('database', 'user', 'password', {
  host: 'localhost',
  dialect: 'sqlite',
  logging: false,
  storage: 'database.sqlite',
});

// 定义Tags模型
const Tags = sequelize.define('tags', {
  name: {
    type: Sequelize.STRING,
    unique: true,
  },
  // 其他字段...
});

// 导出Sequelize实例和模型
module.exports = {
  sequelize,
  Tags
};

步骤2：修改index.js，引入数据库模块 #

移除原文件中的Sequelize初始化和Tags定义，改为引入db.js：

const fs = require('node:fs');
const path = require('node:path');
const keep_alive = require("./keep_alive.js");
// 引入数据库模块
const { sequelize, Tags } = require('./db.js');

const { Client, Collection, Events, GatewayIntentBits, EmbedBuilder, PermissionsBitField, Permissions, SlashCommandBuilder} = require('discord.js');

const client = new Client({intents: [GatewayIntentBits.Guilds, GatewayIntentBits.GuildMessages]});
client.cooldowns = new Collection();
client.commands = new Collection();

// Secret values
const token = process.env['token']
const CLIENT_ID = process.env['client_id']
const GUILD_ID = process.env['guild_id']

// 读取命令部分保持不变
client.commands = new Collection();
const foldersPath = path.join(__dirname, 'commands');
const commandFolders = fs.readdirSync(foldersPath);

for (const folder of commandFolders) {
  const commandsPath = path.join(foldersPath, folder);
  const commandFiles = fs.readdirSync(commandsPath).filter(file => file.endsWith('.js'));
  for (const file of commandFiles) {
    const filePath = path.join(commandsPath, file);
    const command = require(filePath);
    if ('data' in command && 'execute' in command) {
      client.commands.set(command.data.name, command);
    } else {
      console.log(`[WARNING] The command at ${filePath} is missing a required "data" or "execute" property.`);
    }
  }
}

// 读取事件部分保持不变，移除index.js里的Tags.sync()调用
const eventsPath = path.join(__dirname, 'events');
const eventFiles = fs.readdirSync(eventsPath).filter(file => file.endsWith('.js'));

for (const file of eventFiles) {
  const filePath = path.join(eventsPath, file);
  const event = require(filePath);
  if (event.once) {
    client.once(event.name, (...args) => event.execute(...args));
  } else {
    client.on(event.name, (...args) => event.execute(...args));
  }
}

client.login(token);

步骤3：修改ready.js，引入数据库模块中的Tags #

直接从db.js引入Tags模型即可：

const { Events } = require('discord.js');
// 引入Tags模型
const { Tags } = require('../db.js');

module.exports = {
  name: Events.ClientReady,
  once: true,
  execute(client) {
    // 现在可以正常调用sync()
    Tags.sync();
    console.log(`Ready! Logged in as ${client.user.tag}`);
  },
};

额外说明 #

• 如果后续需要添加更多模型，可在db.js中定义并导出，或创建models文件夹拆分多个模型文件，再在db.js中统一导入导出，保持结构清晰。
• 这种方式彻底避免了循环引用问题，同时让数据库逻辑与Discord客户端逻辑解耦，更符合模块化开发规范。

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