aiogram3中用户分页Inline按钮回调失效问题求助

技术栈与功能概述 #

基于aiogram3开发站点管理机器人，支持用户与新闻的增删改查操作；后端采用Django+SQLite+Rest-framework架构，数据分页通过后端Paginator类实现；机器人已使用Router拆分不同目录的处理器。

问题详情 #

展示新闻/用户列表时，通过Inline按钮实现分页导航：新闻分页按钮回调正常工作，但用户分页按钮点击后无响应，控制台仅输出日志：INFO:aiogram.event:Update id=769373400 is handled. Duration 0 ms by bot id=6151615027。推测问题源于Router的匹配机制，新闻与用户使用相似按钮，导致请求未到达用户路由。

• 新闻分页可正常跳转，用户分页点击按钮无任何反馈
• 最初新闻与用户共用键盘生成函数，拆分后问题仍未解决

核心代码片段 #

路由配置（main.py） #

dp.include_routers(bot_commands.bot_commands_router)
dp.include_routers(get_news_handlers.get_news_router)
dp.include_routers(get_users_handlers.get_users_router)

分页核心函数 #

@database_sync_to_async
def pagination(page_number, model):
    get_model = model
    paginator = Paginator(get_model, 5)
    page_obj = paginator.get_page(page_number)
    page_previous = page_obj.has_previous()
    page_next = page_obj.has_next()
    all_pages = paginator.num_pages

    return list(page_obj), page_previous, all_pages, page_next

用户回调处理器 #

@get_users_router.callback_query(lambda c: True)
async def get_users_callback(callback: CallbackQuery,
                             state: FSMContext):

    data = await state.get_data()

    if 'to users' in callback.data:
        page = int(callback.data.split(' ')[2])
        await state.update_data(page=page)
        paginator, has_previous_page, all_pages, has_next_page = await pagination(page_number=page,
                                                                                  model=data['all_users'])

        response_text_users = []
        for user in paginator:
            response_text_users.append(
                f'<b>id пользователя:</b> {user.pk}\n'
                f'<b>Имя пользователя:</b> {user.username}\n'
            )

        keyboard = get_users_keyboards(page=page,
                                       has_previous_page=has_previous_page,
                                       all_pages=all_pages,
                                       has_next_page=has_next_page,
                                       )

        await callback.message.edit_text(text=''.join(response_text_users), reply_markup=keyboard)
        await state.set_state(GlobalState.waiting_for_user)

用户键盘生成函数 #

def get_users_keyboards(page, has_previous_page, all_pages, has_next_page):
    
    next_page = page + 1 if has_next_page else page
    previous_page = page - 1 if has_previous_page else page

    buttons = [
        [
            InlineKeyboardButton(text='⏪', callback_data=f'to users {1}'),
            InlineKeyboardButton(text='◀', callback_data=f'to users {previous_page}'),
            InlineKeyboardButton(text=f'{page}/{all_pages}', callback_data=f'all users'),
            InlineKeyboardButton(text='▶', callback_data=f'to users {next_page}'),
            InlineKeyboardButton(text='⏩', callback_data=f'to users {all_pages}')
        ]
    ]
    if not has_previous_page:
        del buttons[0][:2]
    if not has_next_page:
        del buttons[0][-2:]
    keyboard = InlineKeyboardMarkup(inline_keyboard=buttons)

    return keyboard

解决思路建议 #

1. 优化Router匹配规则：当前路由顺序是bot_commands_router → get_news_router → get_users_router，如果新闻路由的回调处理器也使用了lambda c: True这类宽泛匹配，会优先捕获所有回调请求，导致用户路由的处理器无法触发。建议给每个路由的回调设置精确过滤器，比如新闻回调只匹配包含to news的data，用户回调只匹配to users的data，避免全局匹配。
2. 验证回调数据格式：检查用户分页按钮的callback_data是否生成正确，比如是否存在空格或格式错误，确保'to users'能被正确识别。
3. 检查状态机状态：确认用户分页时状态机是否处于GlobalState.waiting_for_user或对应状态，避免状态不匹配导致处理器不生效。
4. 添加调试日志：在用户回调处理器开头添加日志输出（如print(callback.data)），确认请求是否进入该处理器；若未进入，说明路由匹配存在问题，需调整路由顺序或过滤器。
5. 排查重复处理器：检查所有路由中是否有其他回调处理器使用了同样宽泛的匹配规则，优先处理了用户分页的回调请求。

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