如何在discord.js中查看机器人所在服务器并实现加入功能

一、查看机器人当前所在服务器 #

机器人登录就绪后，可通过client.guilds.cache获取所有已加入服务器的缓存集合，遍历集合即可提取服务器信息：

const { Client, GatewayIntentBits } = require('discord.js');
const client = new Client({ intents: [GatewayIntentBits.Guilds] });

client.on('ready', () => {
  console.log(`已登录为 ${client.user.tag}`);
  console.log('当前所在服务器列表：');
  // 遍历服务器，输出名称、ID和成员数
  client.guilds.cache.forEach(guild => {
    console.log(`- ${guild.name} (ID: ${guild.id}) | 成员数：${guild.memberCount}`);
  });
});

client.login('你的机器人Token');

client.guilds.cache是Collection类型对象，每个元素为Guild实例，可调用guild.iconURL()、guild.ownerId等属性获取更多服务器细节。

二、实现机器人加入服务器的功能 #

机器人无法主动未经授权加入服务器，必须由目标服务器管理员通过OAuth2邀请链接完成添加。以下是两种生成邀请链接的方式：

1. 生成通用bot邀请链接（支持添加到任意服务器） #

构造带有bot权限的OAuth2链接，管理员打开链接即可将机器人添加到自己的服务器：

const clientId = '你的机器人客户端ID';
// 权限数值，8代表管理员权限，其他权限可参考Discord官方权限对照表
const requiredPermissions = 8;
const inviteLink = `https://discord.com/oauth2/authorize?client_id=${clientId}&permissions=${requiredPermissions}&scope=bot%20applications.commands`;

console.log(`机器人通用邀请链接：${inviteLink}`);

2. 生成特定服务器的邀请链接（机器人已在该服务器） #

若机器人已在目标服务器且拥有CREATE_INSTANT_INVITE权限，可通过代码生成该服务器的邀请链接：

client.on('ready', () => {
  const targetGuildId = '目标服务器ID';
  const guild = client.guilds.cache.get(targetGuildId);
  
  if (!guild) {
    console.error('未找到目标服务器');
    return;
  }

  // 定位服务器内的文本频道
  const textChannel = guild.channels.cache.find(channel => channel.type === 0);
  if (!textChannel) {
    console.error('服务器内无可用文本频道');
    return;
  }

  // 创建永久有效、不限次数的邀请链接
  textChannel.createInvite({
    maxAge: 0,
    maxUses: 0
  })
  .then(invite => console.log(`服务器邀请链接：${invite.url}`))
  .catch(err => console.error('创建邀请失败：', err));
});

注意事项 #

• 确保机器人Token和客户端ID正确，v14及以上版本需显式声明Guilds意图
• 生成通用邀请链接时，按需调整权限数值，避免过度授权
• 创建特定服务器邀请时，机器人必须在目标服务器内，且拥有创建邀请的权限

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