基于Discord.JS：如何检查用户是否授权机器人并分配验证角色

这个功能完全可行，核心是通过Discord OAuth2流程完成用户授权，再结合Discord.js的服务器角色管理能力实现自动分配。以下是具体实现步骤和代码修改方案：

一、前置准备 #

1. 到Discord开发者平台，为你的机器人应用配置OAuth2：

   • 进入「OAuth2 → General」，添加重定向URI（比如http://localhost:3000/callback，本地测试用）
   • 进入「OAuth2 → URL Generator」，勾选以下权限：
     • 身份认证权限：identify（获取用户基本信息）
     • 服务器权限：manage_roles（管理角色）、guilds.members.write（修改成员角色）
   • 复制生成的授权链接备用

2. 安装必要依赖：

npm install express discord.js

二、修改现有代码，添加OAuth2处理逻辑 #

首先补上现有代码缺失的fs和path模块引入：

const fs = require('fs');
const path = require('path');
const { Client, Events, GatewayIntentBits } = require('discord.js');
const { token, clientId, clientSecret, redirectUri } = require('./config.json'); // 新增clientId、clientSecret、redirectUri到配置文件
const { Collection } = require('discord.js');
const express = require('express');
const app = express();

1. 添加HTTP服务器处理授权回调 #

在客户端初始化后添加：

// 处理授权回调
app.get('/callback', async (req, res) => {
  const { code } = req.query;
  if (!code) return res.send('授权失败，未获取到code');

  try {
    // 用code交换access token
    const tokenResponse = await fetch('https://discord.com/api/oauth2/token', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/x-www-form-urlencoded'
      },
      body: new URLSearchParams({
        client_id: clientId,
        client_secret: clientSecret,
        code: code,
        grant_type: 'authorization_code',
        redirect_uri: redirectUri,
        scope: 'identify guilds.members.write'
      })
    });

    const tokenData = await tokenResponse.json();
    if (!tokenData.access_token) return res.send('获取access token失败');

    // 获取授权用户的信息
    const userResponse = await fetch('https://discord.com/api/users/@me', {
      headers: {
        Authorization: `Bearer ${tokenData.access_token}`
      }
    });
    const user = await userResponse.json();

    // 找到目标服务器和用户
    const guild = client.guilds.cache.get('你的服务器ID'); // 替换成你的服务器ID
    if (!guild) return res.send('未找到目标服务器');

    const member = await guild.members.fetch(user.id);
    if (!member) return res.send('用户不在服务器中');

    // 分配验证角色
    const roleId = '你的验证角色ID'; // 替换成你的验证角色ID
    await member.roles.add(roleId);

    res.send('授权成功，已为你分配验证角色！');
  } catch (error) {
    console.error('授权回调处理失败:', error);
    res.send('授权处理出错，请重试');
  }
});

// 启动HTTP服务器
app.listen(3000, () => {
  console.log('授权回调服务器已启动，监听端口3000');
});

2. 添加一个命令生成授权链接 #

在你的commands文件夹下新建auth.js命令文件：

const { SlashCommandBuilder } = require('discord.js');
const { clientId, redirectUri } = require('../config.json');

module.exports = {
  data: new SlashCommandBuilder()
    .setName('auth')
    .setDescription('点击链接完成账号授权，获取验证角色'),
  async execute(interaction) {
    // 生成授权链接
    const authUrl = `https://discord.com/api/oauth2/authorize?client_id=${clientId}&redirect_uri=${encodeURIComponent(redirectUri)}&response_type=code&scope=identify%20guilds.members.write`;
    await interaction.reply({ content: `请点击此链接完成授权：${authUrl}`, ephemeral: true });
  },
};

3. 检查用户是否已授权 #

如果需要主动检查用户是否完成授权，有两种常用方式：

• 方式一：存储授权状态：在回调处理时，将用户ID存入数据库（如SQLite、MongoDB），后续通过查询数据库判断用户是否已授权。
• 方式二：验证access token：如果保存了用户的access token，可调用Discord API验证有效性：

async function checkUserAuth(accessToken) {
  try {
    const response = await fetch('https://discord.com/api/users/@me', {
      headers: {
        Authorization: `Bearer ${accessToken}`
      }
    });
    return response.ok;
  } catch (error) {
    return false;
  }
}

三、注意事项 #

• 确保机器人在服务器中的角色位置高于要分配的验证角色，否则无法添加角色。
• 生产环境中建议使用HTTPS作为重定向URI，避免安全风险。
• 敏感信息（clientId、clientSecret）建议存入环境变量，不要硬编码到代码中。

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