如何在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
相关产品推荐
相关产品推荐

