discord.py 机器人在私信中能正常执行命令，但在服务器频道无响应，根本原因是未启用 message_content 这一特权意图（Privileged Intent），导致 bot 无法读取用户发送的命令消息内容。
discord.py 机器人在私信中能正常执行命令，但在服务器频道无响应，根本原因是未启用 `message_content` 这一特权意图（privileged intent），导致 bot 无法读取用户发送的命令消息内容。
在 discord.py v2.0+ 中，为了遵守 Discord 的隐私政策，message.content（即用户消息的文本内容）默认被屏蔽，即使 bot 拥有读取消息权限，也必须显式启用 message_content 意图，并在 Discord 开发者门户中手动开启对应特权开关，命令系统才能在服务器中正常工作。
你的日志中已明确提示问题所在：
WARNING discord.ext.commands.bot Privileged message content intent is missing, commands may not work as expected.
✅ 正确配置 message_content 意图
只需在初始化 Intents 时添加一行：
intents = discord.Intents.default() intents.message_content = True # ? 关键：启用特权意图（必须） intents.guilds = True intents.messages = True intents.members = True intents.reactions = True
⚠️ 注意：intents.messages = True 仅允许接收消息事件（如 on_message），但不包含读取消息内容的能力；message_content 是独立的、需显式启用的特权意图。
? 同步完成两步操作（缺一不可）
- 代码侧：如上设置 intents.message_content = True；
-
Discord 开发者门户侧：
- 进入 Discord Developer Portal → 选择你的应用 → Bot 标签页；
- 在 Privileged Gateway Intents 区域，勾选 ✅ Message Content Intent；
- 保存更改。
? 提示：若 Bot 已加入服务器，无需重新邀请，但需确保邀请链接中包含 applications.commands 和 bot scope —— 你当前的邀请链接已满足（含 scope=applications.commands+bot），但建议补充 message_content 权限（虽非 invite 参数，而是后台开关）。
? 完整修正后的初始化代码（推荐写法）
import os
import discord
from discord.ext import commands
from dotenv import load_dotenv
load_dotenv()
discord_key = os.getenv("DISCORD_KEY")
# 启用所有必需意图，特别注意 message_content
intents = discord.Intents.default()
intents.message_content = True # 必须启用（特权意图）
intents.guilds = True
intents.messages = True
intents.members = True
intents.reactions = True
bot = commands.Bot(command_prefix="!", intents=intents)
@bot.event
async def on_ready():
print(f'{bot.user} está online!')
@bot.event
async def on_message(message):
# ⚠️ 重要：务必调用 process_commands，且放在自定义逻辑之后（如有）
await bot.process_commands(message)
@bot.command()
async def ola(ctx):
await ctx.send(f'Olá, {ctx.author.mention}!')
@bot.command()
async def soma(ctx, num1: int, num2: int):
await ctx.send(f'A soma de {num1} e {num2} é {num1 + num2}.')
bot.run(discord_key)
? 补充说明与最佳实践
- on_message 事件中必须保留 await bot.process_commands(message)，否则装饰器 @bot.command() 定义的命令将完全失效；
- 若你在 on_message 中添加了自定义逻辑（如关键词回复），请确保 process_commands 调用不被 return 或异常中断；
- 使用 !help 测试命令是否注册成功：若返回帮助菜单，说明命令系统已就绪；
- Docker 日志中的 WARNING 消失即表示配置生效（重启容器后观察）。
完成以上配置后，你的机器人即可在服务器文本频道中正确解析并响应 !ola、!soma 等命令。记住：message_content 是现代 discord.py 的“钥匙”，没有它，命令系统在服务器中形同虚设。
