Discord 机器人创建与配置完整指南

准备好环境后，我们可以用 Python 快速验证连接。这里以 discord.py 为例，展示如何接收消息并处理附件。

import discord
from dotenv import load_dotenv
import os

# 加载环境变量中的 Token
load_dotenv()
TOKEN = os.getenv('DISCORD_TOKEN')

intents = discord.Intents.default()
intents.message_content = True  # 必须开启此意图才能读取内容

client = discord.Client(intents=intents)

@client.event
async def on_ready():
    print(f'Bot {client.user} 已上线！')

@client.event
async def on_message(message):
    # 忽略 Bot 自己的消息
    if message.author == client.user:
        return
    
    # 简单响应逻辑
    if message.content.startswith('!hello'):
        await message.channel.send('Hello there!')
    
    # 如果有附件，打印文件名
    if message.attachments:
        for attachment in message.attachments:
            print(f'收到附件：{attachment.filename}')

if __name__ == '__main__':
    client.run(TOKEN)

运行脚本后，观察控制台输出。如果看到 Bot ... 已上线！，说明连接成功。尝试在 Discord 发送消息，检查是否触发相应事件。

5. 常见问题排查

• 读不到 message.content：双重检查开发者面板是否开启了 Message Content Intent，且代码中 intents.message_content = True 已生效。
• 403 权限错误：确认 Bot 在服务器的角色/频道中有 View Channel 和 Read Message History 权限，且 OAuth2 页面勾选了正确权限。
• API 限流：生产环境中请做好日志记录、错误重试和速率限制处理，避免频繁请求导致 Discord API 暂时封禁。
• 邀请失败：发起邀请的用户必须在目标服务器拥有'管理服务器'或相应的邀请权限。