使用aiogram开发Telegram Bot时遭遇MessageToEditNotFound报错

核心问题 #

你遇到的MessageToEditNotFound错误，本质是用相对消息ID（message.message_id - 1）定位目标消息的逻辑完全不可靠：

• 第一次执行select→cancel时，带"cancel"按钮的消息（记为M2）的前一条确实是原消息（M1），此时message_id-1能正确指向M1；
• 但第一次cancel操作会删除M2，当你第二次执行select时，会发送新的"cancel"消息（M3），此时M3的message_id-1指向的是已经被删除的M2，而非原消息M1，自然会触发找不到消息的报错。

另外代码还有两个隐性问题：

1. C和D函数误用@dp.message_handler()装饰器，它们实际是被回调查询触发的，不符合aiogram的设计规范；
2. 没有持久化原消息的ID，导致无法准确追踪需要编辑的目标消息。

修复方案 #

步骤1：动态传递原消息ID #

将原消息ID嵌入cancel按钮的callback_data中，确保每次cancel操作都能精准定位到需要恢复的原消息。

步骤2：重构代码逻辑 #

from aiogram.types import InlineKeyboardMarkup, InlineKeyboardButton
from aiogram import Bot, Dispatcher, types
from aiogram.utils.exceptions import MessageToEditNotFound

# 保留原键盘定义
call = InlineKeyboardMarkup(
    inline_keyboard=[
        [InlineKeyboardButton(text='select', callback_data='cll')],
        [InlineKeyboardButton(text='back', callback_data='bl')]
    ]
)

call1 = InlineKeyboardMarkup(
    inline_keyboard=[
        [InlineKeyboardButton(text='back', callback_data='bl')]
    ]
)

# 动态生成cancel键盘，传入原消息ID
def get_cancel_markup(original_msg_id: int):
    return InlineKeyboardMarkup(
        inline_keyboard=[
            [InlineKeyboardButton(text='cancel', callback_data=f'off:{original_msg_id}')]
        ]
    )

# 直接处理select回调
@dp.callback_query_handler(lambda c: c.data == 'cll')
async def handle_select(callback: types.CallbackQuery):
    # 修改原消息的reply markup
    await callback.message.edit_reply_markup(reply_markup=call1)
    # 发送带cancel按钮的消息，携带原消息ID
    await callback.message.answer('You selected it', reply_markup=get_cancel_markup(callback.message.message_id))
    # 结束回调加载状态
    await callback.answer()

# 处理cancel回调
@dp.callback_query_handler(lambda c: c.data.startswith('off:'))
async def handle_cancel(callback: types.CallbackQuery):
    # 从callback_data中解析原消息ID
    original_msg_id = int(callback.data.split(':')[1])
    chat_id = callback.message.chat.id

    try:
        # 恢复原消息的reply markup
        await bot.edit_message_reply_markup(chat_id=chat_id, message_id=original_msg_id, reply_markup=call)
        # 删除当前带cancel按钮的消息
        await bot.delete_message(chat_id=chat_id, message_id=callback.message.message_id)
    except MessageToEditNotFound:
        # 容错：原消息已被删除时，直接删除当前消息
        await bot.delete_message(chat_id=chat_id, message_id=callback.message.message_id)
    finally:
        await callback.answer()

# 保留s1回调处理
@dp.callback_query_handler(lambda c: c.data == 's1')
async def handle_s1(callback: types.CallbackQuery):
    await callback.message.edit_text('Theme1', reply_markup=call)
    await callback.answer()

关键优化点 #

1. 精准定位：通过将原消息ID嵌入按钮的回调数据，彻底避免了相对ID的不可靠问题；
2. 规范处理：直接用@dp.callback_query_handler()处理按钮事件，符合aiogram的事件流逻辑；
3. 容错机制：添加异常捕获，避免原消息被意外删除导致的报错；
4. 用户体验：所有回调都调用callback.answer()，避免按钮一直处于加载状态。

内容的提问来源于stack exchange，提问作者Марсель Юлдашев