Aiogram中如何控制Handler的执行范围与时机？

你的需求本质是临时切换对话上下文，只允许特定处理器响应消息，直到用户触发结束指令。原代码的问题在于内部注册的处理器会被永久添加到Dispatcher，无法自动移除，且全局处理器仍会被匹配。使用Aiogram内置的**有限状态机（FSM）**是最标准、优雅的实现方式。

改造后的完整代码 #

import asyncio
import logging
from aiogram import Bot, Dispatcher, types
from aiogram.filters import Text
from aiogram.filters.command import Command
from aiogram.utils.keyboard import ReplyKeyboardBuilder
from aiogram.fsm.state import State, StatesGroup
from aiogram.fsm.context import FSMContext

logging.basicConfig(level=logging.INFO)
bot = Bot(token="TOKEN")
dp = Dispatcher()

# 定义对话状态
class ItemStates(StatesGroup):
    collecting = State()  # 标记当前处于收集物品的对话阶段

@dp.message(Command("start"))
async def cmd_start(message: types.Message):
    builder = ReplyKeyboardBuilder()
    builder.row(types.KeyboardButton(text="Begin"))
    await message.answer(
        'Hello, press to button',
        reply_markup=builder.as_markup(resize_keyboard=True)
    )

@dp.message(Text('Begin'))
async def new_client_services(message: types.Message, state: FSMContext):
    builder = ReplyKeyboardBuilder()
    builder.row(types.KeyboardButton(text="End"))
    await message.answer(
        "Please write down all your items lying on the table one by one",
        reply_markup=builder.as_markup(resize_keyboard=True)
    )
    # 切换到收集物品的状态，后续仅匹配带该状态过滤的处理器
    await state.set_state(ItemStates.collecting)

# 仅在收集状态下响应End指令
@dp.message(ItemStates.collecting, Text('End'))
async def end_save_services(message: types.Message, state: FSMContext):
    await message.reply("Excellent", reply_markup=types.ReplyKeyboardRemove())
    # 清除状态，恢复全局处理器的匹配逻辑
    await state.clear()

# 仅在收集状态下响应物品输入消息
@dp.message(ItemStates.collecting)
async def with_puree(message: types.Message):
    # 此处可添加MySQL存储逻辑
    await message.answer(f"Items {message.text} add✅\n")

# 仅在非收集状态下响应其他消息
@dp.message()
async def default_handler(message: types.Message):
    await message.reply("Please, push button")

async def main():
    await dp.start_polling(bot)

if __name__ == "__main__":
    asyncio.run(main())

关键逻辑说明 #

• 状态标记：通过StatesGroup定义collecting状态，明确当前对话所处的阶段。
• 状态切换：用户发送Begin后，调用state.set_state()切换状态，此时Dispatcher只会匹配带有ItemStates.collecting过滤条件的处理器，全局默认处理器不会被触发。
• 状态隔离：End指令处理器和物品输入处理器都绑定了ItemStates.collecting过滤，确保只有在收集阶段才会响应。
• 状态重置：用户发送End后，调用state.clear()清除状态，后续消息回到全局处理器的匹配流程。

为什么不使用动态注册/移除处理器？ #

虽然可以通过dp.message.register()和dp.message.unregister()手动管理处理器，但这种方式需要跟踪所有临时注册的处理器，容易出现逻辑混乱或内存泄漏问题。FSM是Aiogram官方推荐的对话流程管理方案，稳定性和可维护性更强。

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