Telegram机器人批量删除指定用户消息功能开发问题求助

代码中的核心问题 #

• 不存在的方法调用：python-telebot没有get_chat_history这个方法，这是导致运行异常的关键原因。
• 逻辑顺序错误：在验证用户权限前就删除了触发命令的消息，不符合权限校验的逻辑。
• 未考虑Telegram删除限制：机器人仅能删除48小时内的消息，且需要拥有聊天的消息删除权限。
• 未处理用户名缺失场景：部分用户未设置username，直接访问msg.from_user.username会引发错误。
• 异常捕获范围不足：原代码的try块未覆盖所有可能出错的步骤。

修复后的代码 #

import datetime

@bot.message_handler(commands=['delete'])
def delete_messages(message):
    user_id = message.from_user.id
    chat_id = message.chat.id

    if user_id != ALLOWED_USER:
        bot.send_message(chat_id, "无操作权限")
        return

    try:
        command_parts = message.text.split(' ')
        if len(command_parts) != 3:
            bot.send_message(chat_id, "命令格式错误，请使用：/delete <用户名> <删除数量>")
            return

        target_username = command_parts[1]
        delete_count = int(command_parts[2])
        if delete_count <= 0:
            bot.send_message(chat_id, "删除数量必须大于0")
            return

        # 删除触发命令的消息
        bot.delete_message(chat_id=chat_id, message_id=message.message_id)
        
        deleted = 0
        # 使用get_updates获取最近消息（默认最多100条，需更多可调整limit，循环取更早消息）
        updates = bot.get_updates(limit=200, chat_id=chat_id)
        
        # 倒序遍历，优先删除最新消息
        for update in reversed(updates):
            if deleted >= delete_count:
                break
            msg = update.message
            if not msg or not msg.from_user:
                continue
            # 处理用户未设置username的情况
            user_username = msg.from_user.username or ""
            if user_username.lower() == target_username.lower():
                # 检查消息是否在48小时有效期内
                if (datetime.datetime.now() - msg.date).total_seconds() <= 48*3600:
                    try:
                        bot.delete_message(chat_id=chat_id, message_id=msg.message_id)
                        deleted += 1
                    except Exception as del_err:
                        print(f"删除单条消息失败：{del_err}")
        
        bot.send_message(chat_id, f"成功删除{deleted}条{target_username}的消息")

    except ValueError:
        bot.send_message(chat_id, "删除数量必须是整数")
    except Exception as e:
        bot.send_message(chat_id, f"操作出错：{str(e)}")

关键修复说明 #

1. 替换历史消息获取方式：用get_updates替代不存在的get_chat_history，若需更早消息，可通过循环调整offset参数分批获取。
2. 调整权限校验逻辑：先校验用户权限，不符合直接返回，避免无效操作。
3. 增加命令格式校验：判断参数数量是否合规，给出明确提示。
4. 处理用户名缺失场景：用户未设置username时用空字符串替代，避免报错。
5. 加入消息有效期校验：严格遵守Telegram仅允许删除48小时内消息的规则。
6. 细化异常捕获：单独捕获数字转换错误，提供更精准的错误提示。

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