Telegram内联按钮分页问题求助（基于python-telebot库）

我之前用python-telebot做机器人时也踩过这个分页的坑，你的问题核心在于回调交互是无状态的，前进/后退按钮没有携带当前页码信息，而且没有正确更新原消息的内联键盘。下面给你一套可直接复用的解决方案：

核心思路 #

1. 把当前页码嵌入前进/后退按钮的callback_data中，让机器人知道要切换到哪一页
2. 写一个通用的键盘生成函数，根据页码生成对应页的按钮组+分页控件
3. 处理回调时，区分分页按钮和普通文档按钮：分页按钮更新原消息的键盘，普通按钮触发文档发送逻辑

完整示例代码 #

import telebot

# 替换成你的机器人token
TOKEN = "你的Telegram机器人Token"
bot = telebot.TeleBot(TOKEN)

# 配置：每页显示的按钮数量
PER_PAGE = 5
# 模拟你的大量文档按钮列表（格式：(按钮文本, 文档标识)）
ALL_DOC_BUTTONS = [
    ("文档1", "doc_001"), ("文档2", "doc_002"), ("文档3", "doc_003"),
    ("文档4", "doc_004"), ("文档5", "doc_005"), ("文档6", "doc_006"),
    ("文档7", "doc_007"), ("文档8", "doc_008"), ("文档9", "doc_009"),
    ("文档10", "doc_010"), ("文档11", "doc_011")
]

def generate_inline_keyboard(page_num):
    """根据页码生成对应页的内联键盘"""
    total_pages = (len(ALL_DOC_BUTTONS) + PER_PAGE - 1) // PER_PAGE  # 向上取整计算总页数
    # 截取当前页的按钮
    start_idx = page_num * PER_PAGE
    end_idx = start_idx + PER_PAGE
    current_page_buttons = ALL_DOC_BUTTONS[start_idx:end_idx]
    
    # 构建文档按钮行
    keyboard = []
    for btn_text, doc_id in current_page_buttons:
        keyboard.append([telebot.types.InlineKeyboardButton(btn_text, callback_data=doc_id)])
    
    # 构建分页按钮行（处理边界：首页无后退，末页无前进）
    pagination_row = []
    if page_num > 0:
        # 后退按钮携带当前页码，方便计算目标页
        pagination_row.append(telebot.types.InlineKeyboardButton("<= 后退", callback_data=f"prev:{page_num}"))
    if page_num < total_pages - 1:
        # 前进按钮携带当前页码
        pagination_row.append(telebot.types.InlineKeyboardButton("前进 =>", callback_data=f"next:{page_num}"))
    
    if pagination_row:
        keyboard.append(pagination_row)
    
    return telebot.types.InlineKeyboardMarkup(keyboard)

# 触发分页菜单的命令（比如/start）
@bot.message_handler(commands=['start'])
def show_document_menu(message):
    bot.send_message(
        chat_id=message.chat.id,
        text="请选择需要查看的文档：",
        reply_markup=generate_inline_keyboard(page_num=0)  # 默认显示首页
    )

# 处理所有内联按钮回调
@bot.callback_query_handler(func=lambda call: True)
def handle_callback(call):
    # 必须先调用这个方法，否则用户点击按钮后会一直显示加载状态
    bot.answer_callback_query(call.id)
    
    # 区分分页按钮和普通文档按钮
    if call.data.startswith("prev:") or call.data.startswith("next:"):
        # 解析回调数据中的当前页码
        action, current_page = call.data.split(":")
        current_page = int(current_page)
        
        # 计算目标页码
        target_page = current_page - 1 if action == "prev" else current_page + 1
        
        # 更新原消息的内联键盘（关键！不是发新消息，而是编辑原有消息的键盘）
        bot.edit_message_reply_markup(
            chat_id=call.message.chat.id,
            message_id=call.message.message_id,
            reply_markup=generate_inline_keyboard(target_page)
        )
    else:
        # 处理普通文档按钮：发送对应文档
        doc_id = call.data
        # 这里替换成你的实际文档发送逻辑，比如从本地读取或从云存储获取
        bot.send_document(
            chat_id=call.message.chat.id,
            document=open(f"{doc_id}.pdf", "rb")  # 示例：假设文档是本地pdf文件
        )
        # 可选：删除原菜单消息，避免界面混乱
        bot.delete_message(call.message.chat.id, call.message.message_id)

# 启动机器人
bot.polling(none_stop=True)

关键注意事项 #

• 必须调用answer_callback_query：如果不调用，用户点击按钮后会一直显示加载动画，影响体验
• 用edit_message_reply_markup更新键盘：不要用send_message发新消息，否则会产生多条消息，分页逻辑混乱
• 边界处理：首页隐藏后退按钮，末页隐藏前进按钮，避免出现无效页码
• 页码计算要准确：总页数用向上取整的方式计算，避免最后一页按钮数量不足时丢失内容

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