Python telebot内联按钮无响应问题排查求助

环境信息 #

• Python 3.13.2
• pyTelegramBotAPI-4.27.0
• Windows 10

问题概述 #

此前长期正常运行的telebot内联按钮突然失效，未修改任何代码。测试基础示例代码后问题依旧：内联按钮可正常显示，但点击后无任何反应，无法触发回调处理器；URL内联按钮和普通按钮功能正常。

测试代码如下：

import telebot
from telebot import types

API_TOKEN = '0123456789:AaBbCcDdEe'

bot = telebot.TeleBot(API_TOKEN)

kb = types.InlineKeyboardMarkup(row_width=1)
btn_types = types.InlineKeyboardButton(text='label1', callback_data='btn_types')
kb.add(btn_types)

@bot.message_handler(commands=['start'])
def send_welcome(message):
    bot.send_message(message.chat.id, "text", reply_markup=kb)

@bot.callback_query_handler(func=lambda call: True)
def answer(call):
    print(call.data)
    if call.data == 'btn_types':
        bot.send_message(call.message.chat.id, "Button clicked")

if __name__ == '__main__':
    bot.polling(none_stop=True)

预期行为：发送/start后显示按钮，点击按钮Bot发送“Button clicked”消息，实际无反应。

可能原因及排查步骤 #

1. 网络与Telegram API服务问题 #

• 检查API连通性：在浏览器访问https://api.telegram.org/bot<你的API_TOKEN>/getMe，若返回Bot基本信息则网络正常；若无法访问或报错，排查本地代理、防火墙设置，确保Python程序能正常请求Telegram API。
• 确认Telegram服务状态：检查官方是否有API服务故障公告。

2. Bot Token有效性与权限问题 #

• 重新生成Token：在BotFather中发送/revoke撤销当前Token，再用/newbot获取新Token替换代码后测试，部分情况下Token会莫名失效。
• 调整隐私设置：在BotFather中通过/mybots选择对应Bot，进入Bot Settings -> Group Privacy，设置为Disable，避免隐私限制导致私有聊天的回调无法触发。

3. 库版本兼容性问题 #

• 调整pyTelegramBotAPI版本：Python 3.13属于较新版本，可能与当前4.27.0版本存在兼容问题。尝试降级到稳定旧版本（如4.6.0）或升级到最新版，执行命令pip install pyTelegramBotAPI==<目标版本号>，替换后重启Bot测试。

4. 本地运行环境问题 #

• 捕获运行异常：在bot.polling()前添加异常捕获代码，查看控制台报错信息：

import time
try:
    bot.polling(none_stop=True)
except Exception as e:
    print(f"Polling error: {e}")
    time.sleep(15)

常见异常包括SSL错误、连接超时等，可针对性排查。

• 关闭安全软件：临时关闭本地防火墙或杀毒软件，确认是否存在网络请求拦截。
• 验证Python环境：用pip list确认pyTelegramBotAPI已安装在当前使用的Python 3.13.2环境中。

5. 回调处理器注册问题 #

• 检查代码顺序：确保@bot.callback_query_handler装饰的函数在bot.polling()之前定义，避免处理器未被注册。
• 简化处理器逻辑：先仅打印回调对象，验证是否能触发：

@bot.callback_query_handler(func=lambda call: True)
def answer(call):
    print(f"Received callback: {call}")

若控制台能输出信息，说明处理器正常，问题出在后续逻辑；若无输出，则回调请求未到达Bot。

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