Discord.py机器人如何为用户分配限时角色实现稳定禁言功能

你提出的基于SQL数据库存储禁言记录+定时巡检的方案完全可行，是当前Discord机器人实现定时禁言的通用生产级方案，可以解决你提到的线程阻塞、崩溃漏解封的两个核心问题。

选择SQLite是因为Python内置支持，无需额外部署服务，适合中小型机器人使用，你也可以根据需求替换为MySQL、PostgreSQL等其他SQL数据库。

1. 依赖导入与表结构初始化 #

首先创建禁言记录表，存储需要的所有字段：

import sqlite3
import asyncio
import discord
from discord.ext import tasks
from datetime import datetime, timedelta

# 初始化数据库连接
conn = sqlite3.connect('mute_records.db')
cursor = conn.cursor()

# 创建禁言表（如果不存在）
cursor.execute('''
CREATE TABLE IF NOT EXISTS mute_records (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    user_id INTEGER NOT NULL,
    guild_id INTEGER NOT NULL,
    mute_role_id INTEGER NOT NULL,
    expire_at INTEGER NOT NULL,
    banned_words TEXT NOT NULL,
    is_active INTEGER DEFAULT 1
)
''')
conn.commit()

2. 违禁词触发时写入禁言记录 #

替换你原有代码中的DO.STUFF()部分，实现加禁言角色+写入数据库的逻辑：

@bot.event
async def on_message(message):
    bannedwords = ['badword1', 'badword2']
    words_in_message = [word for word in bannedwords if word in message.content]
    word_string = ", ".join(words_in_message)
    yourServer = bot.get_guild(SERVER_ID)
    # 提前配置好的禁言角色ID，比按名字查找更稳定
    MUTE_ROLE_ID = 1234567890 # 替换为你服务器的Muted角色ID
    mute_duration = 300 # 禁言时长，单位秒，这里示例是5分钟，可根据需求调整
    
    if not message.author.bot:
        if words_in_message:
            # 给用户加禁言角色
            mute_role = yourServer.get_role(MUTE_ROLE_ID)
            await message.author.add_roles(mute_role)
            
            # 计算到期时间Unix时间戳
            expire_at = int((datetime.now() + timedelta(seconds=mute_duration)).timestamp())
            
            # 写入数据库
            cursor.execute('''
            INSERT INTO mute_records (user_id, guild_id, mute_role_id, expire_at, banned_words)
            VALUES (?, ?, ?, ?, ?)
            ''', (message.author.id, yourServer.id, MUTE_ROLE_ID, expire_at, word_string))
            conn.commit()
            
            # 可选：给用户发私信提醒
            try:
                await message.author.send(f"你因发送违禁词 {word_string} 被禁言5分钟，到期将自动解封。")
            except:
                # 用户关闭了私信就跳过
                pass
    await bot.process_commands(message)

3. 定时巡检解封任务 #

用discord.py内置的tasks扩展实现每分钟巡检，自动解封到期用户：

# 定义定时任务，每分钟执行一次
@tasks.loop(minutes=1)
async def auto_unmute_task():
    current_ts = int(datetime.now().timestamp())
    # 查询所有到期且还在生效的禁言记录
    cursor.execute('''
    SELECT id, user_id, guild_id, mute_role_id FROM mute_records
    WHERE is_active = 1 AND expire_at < ?
    ''', (current_ts,))
    expired_records = cursor.fetchall()
    
    for record in expired_records:
        record_id, user_id, guild_id, mute_role_id = record
        guild = bot.get_guild(guild_id)
        if not guild:
            # 服务器不存在了，直接标记为失效
            cursor.execute('UPDATE mute_records SET is_active = 0 WHERE id = ?', (record_id,))
            conn.commit()
            continue
        member = guild.get_member(user_id)
        mute_role = guild.get_role(mute_role_id)
        if member and mute_role in member.roles:
            # 解除禁言
            await member.remove_roles(mute_role)
        # 标记记录为失效
        cursor.execute('UPDATE mute_records SET is_active = 0 WHERE id = ?', (record_id,))
        conn.commit()

# 机器人启动时同时启动定时任务
@bot.event
async def on_ready():
    # 启动前先执行一次巡检，处理停机期间到期的禁言
    await auto_unmute_task()
    auto_unmute_task.start()
    print("机器人已启动")

• 所有时间统一使用Unix时间戳存储和比较，避免时区不一致导致的解封时间错误
• 优先使用ID查找角色、服务器、用户，不要依赖名称，避免管理人员修改名称后逻辑失效
• 解除禁言时做好异常判断，避免用户已经离开服务器、角色被删除等情况导致的代码报错

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