Python开发Discord Bot遇OperationalError：blacklist表不存在

安全阿岳

2026-8-9

解决Discord机器人SQLite no such table: blacklist 异常

问题核心

数据库未创建blacklist表，导致db_manager.py第8行执行SELECT * FROM blacklist WHERE user_id=?时触发sqlite3.OperationalError
即使删除部分检查逻辑，仍有其他代码路径调用db_manager.is_blacklisted方法，未完全消除异常触发点，最终出现Task exception was never retrieved

修复步骤

1. 初始化`blacklist`表

在db_manager.py中添加数据库初始化逻辑，确保表存在：

import sqlite3

def init_database():
    conn = sqlite3.connect('bot_database.db')  # 替换为你的数据库文件路径
    cursor = conn.cursor()
    # 创建blacklist表，不存在才执行创建
    cursor.execute('''
        CREATE TABLE IF NOT EXISTS blacklist (
            user_id INTEGER PRIMARY KEY,
            reason TEXT,
            created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
        )
    ''')
    conn.commit()
    conn.close()

# 机器人启动时调用初始化函数
init_database()

2. 清理所有`is_blacklisted`调用

全局搜索项目中调用db_manager.is_blacklisted的位置，包括：
- checks.py中的命令校验逻辑
- 消息、成员加入等事件监听代码
- 后台定时任务或异步任务
删除所有未用到的调用，避免无效触发数据库查询

3. 捕获后台任务异常

针对Discord.py的后台任务，添加异常捕获避免Task exception was never retrieved：

from discord.ext import tasks

@tasks.loop(hours=12)
async def example_background_task():
    try:
        # 任务逻辑，若包含is_blacklisted调用需确认表已初始化
        pass
    except sqlite3.OperationalError as err:
        print(f"后台任务执行失败: {err}")