ES6 import无法识别文件变更：Discord Bot重载命令故障排查

问题描述 #

用ES模块开发Discord Bot，执行重载命令后，修改过的命令文件内容没有被加载，还是旧的逻辑。Node.js版本为v18.9.0。

文件夹结构 #

application
├── src
│   ├── handlers
│   │   └── commands.js
│   └── commands
│       └── reload.js

相关代码 #

handlers/commands.js

import { readdirSync } from 'fs';

async function reloadCommands(client) {
    await client.commands.clear();
    await client.aliases.clear();
    const commandFiles = readdirSync('./src/commands').filter(file => file.endsWith('.js'));
    for (let i = 0; i < commandFiles.length; i++) {
        const cmd = await import(`../commands/${commandFiles[i]}`);
        await client.commands.set(cmd.default.name, cmd.default);
        console.log(`[COMMAND] Reloaded ${commandFiles[i]} with command ${cmd.default.name}${cmd.default.aliases}`);

        if (cmd.default.aliases) {
            cmd.default.aliases.forEach(async (alias)  => {
                await client.aliases.set(alias, cmd.default);
            });
        }
    }
    return commandFiles.length;
}

export default { reloadCommands };

commands/reload.js

import commandHandler from '../handlers/commands.js';

export default {
    name: 'reload',
    description: 'Reloads all commands',
    aliases: ['rl'],

    async execute(message, args, client) {
        try {
            let cmdCount = await commandHandler.reloadCommands(client);
            message.reply(`${cmdCount} commands have been reloaded!`);
        } catch (error) {
            console.log(error);
            message.reply('重载命令时出错了！');
        }
    }
};

问题原因 #

Node.js的ES模块机制会缓存已加载的模块，当你通过import()加载同一个路径的模块时，第二次及之后的调用都会直接返回缓存的结果，不会重新读取磁盘上的修改文件，这就是重载后看不到更新内容的核心原因。

解决方案 #

方法1：添加随机查询参数绕过缓存 #

最简单的解决方式是给import()的路径添加一个随机参数（比如时间戳），让Node.js每次都认为是新的模块路径，从而重新加载文件。

修改commands.js中的import行：

// 替换原有import代码
const cmd = await import(`../commands/${commandFiles[i]}?t=${Date.now()}`);

原理：Node.js会将带有不同查询参数的URL视为不同的模块，因此每次调用都会重新读取文件内容，彻底绕过缓存。

方法2：用文件系统读取并动态求值（进阶） #

如果不想依赖URL参数，可以直接读取文件内容，通过eval动态执行代码并获取导出。这种方式需要处理模块作用域，适合更复杂的场景：

import { readFileSync } from 'fs';
import { fileURLToPath } from 'url';
import { dirname, join } from 'path';

const __filename = fileURLToPath(import.meta.url);
const __dirname = dirname(__filename);

async function reloadCommands(client) {
    await client.commands.clear();
    await client.aliases.clear();
    const commandsDir = join(__dirname, '../commands');
    const commandFiles = readdirSync(commandsDir).filter(file => file.endsWith('.js'));
    
    for (let i = 0; i < commandFiles.length; i++) {
        const filePath = join(commandsDir, commandFiles[i]);
        const fileContent = readFileSync(filePath, 'utf8');
        
        // 创建模拟的模块环境
        const moduleExports = {};
        // 执行文件内容，替换export default为模块导出赋值
        await eval(`
            async function executeModule() {
                ${fileContent.replace('export default', 'moduleExports.default =')}
            }
            executeModule();
        `);
        
        const cmd = moduleExports.default;
        await client.commands.set(cmd.name, cmd);
        console.log(`[COMMAND] Reloaded ${commandFiles[i]} with command ${cmd.name}${cmd.aliases}`);

        if (cmd.aliases) {
            cmd.aliases.forEach(async (alias)  => {
                await client.aliases.set(alias, cmd);
            });
        }
    }
    return commandFiles.length;
}

注意：这种方式需要处理命令文件中的import语句，如果命令依赖其他模块，需要额外处理动态加载，复杂度较高，推荐优先用方法1。

额外优化：用绝对路径避免路径问题 #

原代码中使用相对路径./src/commands，如果Bot的启动目录变化可能导致路径错误，建议用path模块拼接绝对路径：

// 替换原有目录读取代码
const commandsDir = join(__dirname, '../commands');
const commandFiles = readdirSync(commandsDir).filter(file => file.endsWith('.js'));

这样无论从哪个目录启动Bot，路径都会正确。

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