You need to enable JavaScript to run this app. 如何在Discord.js开发中使用async/await实现异步文件读写
优惠活动
大模型
产品
解决方案
定价
更多

如何在Discord.js开发中使用async/await实现异步文件读写

Discord.js机器人异步文件读写改造方案

核心问题根因

  • 同步调用fs.readFileSync/fs.writeFileSync会阻塞Node.js事件循环,所有依赖事件循环的逻辑(包括音乐播放的语音流处理、Discord网关心跳)都会被暂停,严重时会触发语音连接超时、机器人断连,表现为修改前缀后音乐功能停止
  • 原代码里的回调式文件读写没有做错误捕获、没有等待操作完成就执行后续逻辑,容易出现JSON格式损坏、数据写入丢失的问题
  • 代码里存在多处语法逻辑bug,会导致功能失效

第一步:引入原生fs Promise版本,封装通用读写方法

Node.js 10+ 版本原生支持fs/promises模块,不需要额外安装第三方依赖,直接可以配合async/await使用:

// 替换原来的fs引入,使用Promise版本
const fs = require('fs/promises');
const path = require('path');
const { MessageEmbed } = require('discord.js');
// 固定文件绝对路径,避免工作目录变动导致的读写出错
const PREFIX_FILE = path.resolve(__dirname, '../prefixes.json');
const defaultConfig = require('../config.json');

// 异步读取全量前缀配置
async function getPrefixes() {
  try {
    const rawContent = await fs.readFile(PREFIX_FILE, 'utf8');
    return JSON.parse(rawContent);
  } catch (err) {
    // 兜底:文件不存在/格式损坏时返回空对象,避免程序崩溃
    console.error('前缀文件读取失败,已重置为空配置', err);
    return {};
  }
}

// 异步写入全量前缀配置
async function savePrefixes(prefixData) {
  try {
    // 写入时格式化JSON结构,避免文件内容压缩成单行不方便维护
    await fs.writeFile(PREFIX_FILE, JSON.stringify(prefixData, null, 2), 'utf8');
    return true;
  } catch (err) {
    console.error('前缀文件写入失败', err);
    return false;
  }
}

第二步:改造prefix设置命令

原命令的两个核心问题:一是同步读文件阻塞事件循环,二是写文件的回调没有等执行完成就发成功消息,还存在括号位置错误的语法bug:

module.exports = {
  name: 'prefix',
  aliases: ['setprefix'],
  description: 'Установить новый префикс на вашем сервере',
  // 必须标记为async,才能在函数内使用await
  async execute(message, args) {
    // 权限判断逻辑保留
    if (!message.member.hasPermission('MANAGE_SERVER')) {
      return message.reply(' Не не не.');
    }
    // 修复原语法bug:原代码写为args[0 == 'help'],会把0和help的比较结果作为索引,永远触发不到help判断
    if (!args[0] || args[0] === 'help') {
      return message.reply(`Использование: prefix <Тут ваш префикс> `);
    }

    // 异步读取现有前缀配置,替代同步readFileSync
    const prefixes = await getPrefixes();
    // 更新当前服务器的前缀
    prefixes[message.guild.id] = {
      prefix: args[0]
    };
    // 等待文件完全写入完成,再执行后续逻辑
    const saveResult = await savePrefixes(prefixes);
    // 写入失败时给用户明确反馈,不要误导用户设置成功
    if (!saveResult) {
      return message.reply('Не удалось сохранить новый префикс, попробуйте позже');
    }

    const pEmbed = new MessageEmbed()
      .setColor('#000001')
      .setTitle('Префикс изменён!')
      .setDescription(`Новый префикс на сервере **${args[0]}**`);

    await message.channel.send(pEmbed);
    // 延迟删除用户的设置命令
    setTimeout(() => {
      if (message.deletable) message.delete().catch(console.error);
    }, 10000);
  }
}

第三步:改造message事件中的前缀读取逻辑

原逻辑中每次收到消息都同步读全量文件,高并发下会严重阻塞事件循环,还存在冷却逻辑的实现bug:

client.on('message', async (message) => {
  if (message.author.bot) return;
  if (!message.guild) return;

  // 异步读取前缀配置,替代同步readFileSync
  const prefixes = await getPrefixes();
  // 没有对应服务器配置时,用全局默认前缀兜底
  if (!prefixes[message.guild.id]) {
    prefixes[message.guild.id] = {
      prefix: config.prefix
    };
    // 把兜底配置异步写回文件,避免每次消息都走重复判断
    await savePrefixes(prefixes);
  }
  const prefix = prefixes[message.guild.id].prefix;

  const prefixRegex = new RegExp(`^(<@!?${client.user.id}>|${escapeRegex(prefix)})\\s*`);
  if (!prefixRegex.test(message.content)) return;
  const [matchedPrefix] = message.content.match(prefixRegex);

  const args = message.content.slice(matchedPrefix.length).trim().split(/ +/);
  const commandName = args.shift().toLowerCase();

  const command =
    client.commands.get(commandName) ||
    client.commands.find((cmd) => cmd.aliases && cmd.aliases.includes(commandName));

  // 修复原逻辑中未定义的commandFiles判断,替换为实际可运行的删除逻辑
  if (message.content.startsWith(prefix) && message.deletable) {
    try {
      await message.delete();
    } catch(e) {
      console.error(e);
    }
  }

  if (!command) return;

  if (!cooldowns.has(command.name)) {
    cooldowns.set(command.name, new Collection());
  }
  // 修复原冷却逻辑bug:原代码cooldowns.set(command.name)返回的是Map本身,不是对应存储的时间集合
  const now = Date.now();
  const timestamps = cooldowns.get(command.name);
  const cooldownAmount = (command.cooldown || 1) * 1000;

  if (timestamps.has(message.author.id)) {
    const expirationTime = timestamps.get(message.author.id) + cooldownAmount;
    if (now < expirationTime) {
      const timeLeft = (expirationTime - now) / 1000;
      return message.reply(
        `Пожалуйста подождите ${timeLeft.toFixed(1)} секунд перед повторным использованием \`${command.name}\` команд.`
      );
    }
  }
  timestamps.set(message.author.id, now);
  setTimeout(() => timestamps.delete(message.author.id), cooldownAmount);

  try {
    // 加await捕获异步执行命令时抛出的错误,避免未处理的Promise rejection
    await command.execute(message, args);
  } catch (error) {
    console.error(error);
    message.reply('Произошла ошибка при выполнении этой команды.')
      .then(message => message.delete({ timeout: 5000 }))
      .catch(console.error);
  }
});

优化建议

  • 增加内存缓存层:程序启动时读一次全量前缀配置存到内存,后续读前缀直接从内存取,只有修改前缀的时候才同步更新内存缓存+写文件,彻底消除高频消息触发的文件IO开销
  • 写文件时增加临时文件写入+原子替换逻辑,避免写入过程中进程崩溃导致prefixes.json完全损坏

内容的提问来源于stack exchange,提问作者Timmi

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.11 21:36:03