Discord.js v14 机器人启动自动删除服务器所有频道问题求助

原代码存在的问题 #

• 变量大小写错误：原代码中使用大写Client调用服务器集合，但导入的客户端实例是小写client，导致无法获取服务器对象
• v14 API适配问题：guilds.get()和channels.array()均为旧版本API，v14中需改用guilds.cache.get()获取服务器缓存、channels.cache获取频道缓存集合
• 遍历逻辑缺陷：普通for循环遍历频道时，删除操作会实时改变缓存集合长度，导致部分频道被遗漏
• 事件注册不规范：直接在模块中绑定client.on("ready")不符合v14事件模块标准写法，且未设置once: true（ready事件仅需触发一次）
• 缺少基础校验：未检查机器人是否有权限删除频道，也未判断目标服务器是否存在

修复后的完整代码 #

const { Client } = require('discord.js');

module.exports = {
    name: 'ready',
    once: true,
    async execute(client) {
        const targetGuildId = '1045245227264397382';
        // 获取目标服务器缓存
        const guild = client.guilds.cache.get(targetGuildId);

        if (!guild) {
            console.error('无法找到目标服务器，请确认服务器ID正确且机器人已加入该服务器');
            return;
        }

        // 检查机器人是否拥有管理频道权限
        const botMember = guild.members.me;
        if (!botMember.permissions.has('ManageChannels')) {
            console.error('机器人缺少「管理频道」权限，无法执行删除操作');
            return;
        }

        // 遍历并删除所有频道，forEach避免缓存长度变化导致的遍历遗漏
        guild.channels.cache.forEach(channel => {
            channel.delete()
                .then(deletedChannel => console.log(`已删除频道：${deletedChannel.name}`))
                .catch(err => console.error(`删除频道失败：${err.message}`));
        });
    }
};

额外注意事项 #

• 确保机器人已加入目标服务器，且服务器管理员已为其授予管理频道权限
• 设置once: true可避免机器人重连时重复执行删除逻辑
• 若服务器频道数量较多，建议添加延迟分批删除（例如用setTimeout），避免触发Discord速率限制

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