Discord机器人Mute命令角色异常求助：是否需使用数据库？

1. 是否需要数据库？ #

• 并非必须，分场景判断：
  • 若机器人需要在重启后保留未到期的禁言记录，必须用数据库（如SQLite、MongoDB）存储用户ID、禁言到期时间、原角色列表等信息。
  • 若只是临时禁言且机器人不会重启，用内存存储（比如全局字典）即可实现，但重启后数据会丢失。

2. 角色层级导致Mute不生效的解决办法 #

Discord权限优先级由角色层级决定，muted角色的层级必须高于用户的其他可发言角色，否则用户的高权限角色会覆盖禁言权限。

• 创建muted角色后，调用edit()方法调整它的位置到所有需要被禁言的角色上方：

  # 创建角色后添加这行，将muted角色移到角色列表最顶部
  await mutedrole.edit(position=len(guild.roles)-1)
  

• 确保muted角色的send_messages、speak等核心发言权限被设为False，并在所有频道中继承这些设置。

3. 恢复原有角色失败的修复 #

当前代码存在两个关键错误：

• await member.add_roles(roles)参数格式错误：add_roles接受单个/多个角色对象，而非列表，需用*roles解包。
• await member.edit(roles=[])会尝试移除无法被删除的@everyone角色，导致后续角色恢复逻辑异常，需过滤掉该默认角色。
• 设置频道权限的逻辑被错误嵌套在if reason==None分支中，应放在创建muted角色的流程里。

修改后的完整代码 #

import asyncio
import discord
from discord.ext import commands

@commands.command()
@commands.has_permissions(manage_messages=True)
async def mute(self, ctx, member: discord.Member=None, time=None, *, reason=None): 
    if not member:
        await ctx.send("请指定要禁言的成员。")
        return
    if time is None:
        await ctx.send("必须设置禁言时长。")
        return
    
    guild = ctx.guild
    muted_role = discord.utils.get(guild.roles, name="muted")
    time_convert = {"s":1, "m":60, "h":3600,"d":86400}
    
    # 处理时长格式错误
    try:
        tempmute = int(time[:-1]) * time_convert[time[-1]]
    except (ValueError, KeyError):
        await ctx.send("时长格式错误，示例：10m（10分钟）、2h（2小时）。")
        return

    # 保存用户原有角色（排除@everyone默认角色）
    original_roles = [role for role in member.roles if role != guild.default_role]
    
    # 创建muted角色（如果不存在）
    if not muted_role:
        muted_role = await guild.create_role(
            name="muted",
            permissions=discord.Permissions(send_messages=False, speak=False, add_reactions=False)
        )
        # 调整角色层级到所有角色上方
        await muted_role.edit(position=len(guild.roles)-1)
        # 给所有频道设置muted角色的权限
        for channel in guild.channels:
            await channel.set_permissions(
                muted_role,
                send_messages=False,
                speak=False,
                add_reactions=False,
                send_messages_in_threads=False,
                create_public_threads=False,
                create_private_threads=False
            )
    
    reason = reason or "无理由"

    # 执行禁言：移除原有角色，添加muted角色
    await member.edit(roles=[muted_role], reason=reason)
    
    # 发送服务器通知
    embed = discord.Embed(description=f"**{member.mention}** 已被禁言，原因：{reason}")
    await ctx.send(embed=embed)
    
    # 尝试发送私信通知
    try:
        dm_embed = discord.Embed(
            description=f"你在 **{guild.name}** 被禁言，原因：{reason}\n\n提示：遵守规则哦！",
            color=0x000000
        )
        await member.send(embed=dm_embed)
    except discord.Forbidden:
        await ctx.send(f"无法给 {member.mention} 发送私信，对方可能关闭了私信权限。")
    
    # 等待禁言时长，恢复角色
    await asyncio.sleep(tempmute)
    await member.remove_roles(muted_role, reason="禁言到期")
    await member.add_roles(*original_roles, reason="恢复原有角色")
    await ctx.send(f"**{member.mention}** 的禁言已到期，已恢复原有角色。")

额外注意事项 #

• 如果需要机器人重启后仍能继续执行未到期的禁言，建议用数据库存储关键信息：
  • 存储字段：用户ID、服务器ID、禁言到期时间、原角色ID列表、muted角色ID
  • 机器人启动时，扫描数据库中未到期的记录，重新设置禁言并启动定时任务

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