Python开发Telegram Bot多级菜单返回按钮冲突问题咨询

你遇到的冲突本质是普通回复键盘（ReplyKeyboardMarkup）完全依赖按钮文本做消息匹配，两个返回按钮文本完全一致，导致匹配逻辑固定走第一个命中的分支。以下是三个可落地的解决方案：

方案1：修改按钮文本（最简快速方案） #

直接给不同层级的返回按钮加不同的文本后缀，让匹配逻辑可以区分：

修改markups.py #

from aiogram.types import ReplyKeyboardMarkup, KeyboardButton

btnMain = KeyboardButton('⬅ Main Menu')
# 给两个返回按钮设置不同文本
btnOtherMain = KeyboardButton('⬅ Back to Other')
btnFoodMain = KeyboardButton('⬅ Back to Main')

# 原有菜单配置保持不变
# Main Menu :
btnRandom = KeyboardButton('♦ Random Number')
btnFood = KeyboardButton('🍕 Random String')
btnOther = KeyboardButton('➡ Other')
mainMenu = ReplyKeyboardMarkup(resize_keyboard = True).add(btnRandom, btnFood, btnOther)

# Other Menu :
btnInfo = KeyboardButton('📚 Information')
btnMoney = KeyboardButton('📈 Exchange Rate')
otherMenu = ReplyKeyboardMarkup(resize_keyboard = True).add(btnInfo, btnMoney, btnMain)

# Sub Other Menu:
subOtherMenu = ReplyKeyboardMarkup(resize_keyboard = True).add(btnOtherMain)

# Food Menu:
subFoodMenu = ReplyKeyboardMarkup(resize_keyboard = True).add(btnFoodMain)

修改main.py的匹配逻辑 #

把原来单个的Back匹配分支拆成两个：

# 替换原来的 elif message.text == '⬅ Back' 分支
elif message.text == '⬅ Back to Main':
    await bot.send_message(message.from_user.id, '⬅ Back', reply_markup = nav.mainMenu)
elif message.text == '⬅ Back to Other':
    await bot.send_message(message.from_user.id, '⬅ Back', reply_markup = nav.otherMenu)

方案2：替换为内联键盘（更规范的推荐方案） #

内联键盘的按钮显示文本和触发数据分离，用户看到的按钮都可以是「⬅ Back」，但后台通过不同的callback_data区分跳转逻辑，用户体验更好：

修改markups.py #

from aiogram.types import InlineKeyboardMarkup, InlineKeyboardButton

# 主菜单按钮
btnRandom = InlineKeyboardButton('♦ Random Number', callback_data='random_num')
btnFood = InlineKeyboardButton('🍕 Random String', callback_data='random_str')
btnOther = InlineKeyboardButton('➡ Other', callback_data='open_other')
mainMenu = InlineKeyboardMarkup().add(btnRandom, btnFood, btnOther)

# Other菜单按钮
btnInfo = InlineKeyboardButton('📚 Information', callback_data='open_info')
btnMoney = InlineKeyboardButton('📈 Exchange Rate', callback_data='exchange_rate')
btnBackMain = InlineKeyboardButton('⬅ Main Menu', callback_data='back_main')
otherMenu = InlineKeyboardMarkup().add(btnInfo, btnMoney, btnBackMain)

# Information菜单按钮
btnBackOther = InlineKeyboardButton('⬅ Back', callback_data='back_other')
subOtherMenu = InlineKeyboardMarkup().add(btnBackOther)

# Random String菜单按钮
btnBackMain2 = InlineKeyboardButton('⬅ Back', callback_data='back_main')
subFoodMenu = InlineKeyboardMarkup().add(btnBackMain2)

修改main.py逻辑，新增回调处理 #

import logging
from aiogram import Bot, Dispatcher, executor, types
import markups as nav
import random

TOKEN = ''

bot = Bot(token=TOKEN)
dp = Dispatcher(bot)

@dp.message_handler(commands=['start'])
async def command_start(message: types.Message):
    await bot.send_message(message.from_user.id, f'Hello {message.from_user.first_name}', reply_markup = nav.mainMenu)

# 处理回调点击
@dp.callback_query_handler(text='random_num')
async def random_num(call: types.CallbackQuery):
    await call.message.answer(str(random.randint(1000,9999)))
    await call.answer()

@dp.callback_query_handler(text='random_str')
async def random_str(call: types.CallbackQuery):
    await call.message.answer('🍕 Random String', reply_markup = nav.subFoodMenu)
    await call.answer()

@dp.callback_query_handler(text='open_other')
async def open_other(call: types.CallbackQuery):
    await call.message.answer('➡ Other', reply_markup = nav.otherMenu)
    await call.answer()

@dp.callback_query_handler(text='back_main')
async def back_main(call: types.CallbackQuery):
    await call.message.answer('⬅ Main Menu', reply_markup = nav.mainMenu)
    await call.answer()

@dp.callback_query_handler(text='back_other')
async def back_other(call: types.CallbackQuery):
    await call.message.answer('⬅ Back', reply_markup = nav.otherMenu)
    await call.answer()

@dp.callback_query_handler(text='open_info')
async def open_info(call: types.CallbackQuery):
    await call.message.answer('📚 Information', reply_markup = nav.subOtherMenu)
    await call.answer()

@dp.callback_query_handler(text='exchange_rate')
async def exchange_rate(call: types.CallbackQuery):
    await call.message.answer('📈 Exchange Rate')
    await call.answer()

if __name__ == '__main__':
    executor.start_polling(dp, skip_updates = True)

方案3：保留相同返回文本+状态管理 #

如果必须保持所有返回按钮文本都是「⬅ Back」，可以接入aiogram的FSM状态管理，记录用户当前所处的菜单层级，点击返回时根据当前状态判断跳转目标：

• 状态设为in_food_menu时，点击Back跳主菜单
• 状态设为in_info_menu时，点击Back跳Other菜单
  这种方案需要额外维护用户状态，适合菜单层级复杂的场景。

内容的提问来源于stack exchange，提问作者B A C H A S H