使用Discord.js实现机器人入服时写入JSON配置的功能报错问题

现有代码存在的具体报错诱因 #

• 未定义属性直接赋值：代码中直接操作client.newGuild，但从未对该属性做初始化，运行时会直接抛出TypeError，提示无法向undefined的对象属性赋值。
• 频道类型判断逻辑过时：discord.js v14版本中，服务器文本频道的类型标识为枚举值ChannelType.GuildText，不再使用字符串"text"作为判断依据，原有过滤逻辑无法匹配到有效频道。
• 空引用无容错：当匹配不到符合条件的文本频道时，chx变量值为undefined，后续访问chx.guild.id会直接触发空引用报错。
• 配置读写逻辑脱节：代码虽然通过fs.readFileSync读取了guilds.json内容并解析为guilds变量，但后续完全没有使用该变量，写入文件时直接用未初始化的client.newGuild作为写入内容，会把原有已存储的服务器配置完全清空。
• 路径不稳定：使用相对路径guilds.json读写文件时，会跟随程序启动的工作目录发生偏移，极易出现文件找不到的问题。

适配需求的修正代码 #

// 引入依赖（需与当前使用的discord.js版本匹配，v14+版本需引入ChannelType枚举）
const fs = require('fs');
const path = require('path');
const { Client, ChannelType } = require('discord.js');

// 固定配置文件的绝对路径，避免相对路径漂移问题
const GUILD_CONFIG_FILE = path.join(__dirname, 'guilds.json');

/**
 * 读取本地guilds.json配置，文件不存在或内容损坏时返回空对象
 */
function getGuildConfig() {
  try {
    const fileContent = fs.readFileSync(GUILD_CONFIG_FILE, 'utf8');
    return JSON.parse(fileContent);
  } catch (err) {
    return {};
  }
}

client.on('guildCreate', (guild) => {
  console.log(`Joined new guild: ${guild.name} (ID: ${guild.id})`);

  // 过滤出机器人有发送消息权限的文本频道，按真实物理位置排序取第一个
  const targetChannel = guild.channels.cache
    .filter(channel => 
      channel.type === ChannelType.GuildText 
      && channel.permissionsFor(guild.members.me).has('SendMessages')
    )
    .sort((a, b) => a.rawPosition - b.rawPosition)
    .first();

  // 找不到可用频道时跳过写入，避免空引用报错
  if (!targetChannel) {
    console.log(`服务器 ${guild.name} 未找到可用文本频道，跳过配置写入`);
    return;
  }

  // 加载现有配置，避免覆盖原有存储内容
  const allGuildConfig = getGuildConfig();
  // 写入当前入服的配置项
  allGuildConfig[guild.id] = {
    MemberAdd: targetChannel.id,
    MemberRemove: targetChannel.id
  };

  // 将更新后的全量配置写回文件
  fs.writeFile(GUILD_CONFIG_FILE, JSON.stringify(allGuildConfig, null, 4), (err) => {
    if (err) {
      console.error('guilds.json写入失败：', err);
      return;
    }
    console.log(`服务器 ${guild.name} 配置已成功存入guilds.json`);
  });
});

配套说明 #

• 代码会自动处理guilds.json不存在的场景，不需要手动提前创建空文件。
• 用rawPosition做频道排序的依据，替代旧的position属性，避免跨分类场景下的频道位置排序错位问题。
• 增加机器人频道权限校验，避免选中机器人无法发送通知的无效频道。

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