Telegram Bot无命令响应故障排查请求

以下是针对你的Bot问题的具体排查步骤和代码优化建议：

一、确认Webhook的实际连通性 #

• 模拟请求测试：用curl向你的WEBHOOK_URL发送POST请求，模拟Telegram的更新数据，比如：

  curl -X POST -H "Content-Type: application/json" -d '{"update_id":12345,"message":{"chat":{"id":67890},"from":{"id":67890},"text":"/start"}}' YOUR_WEBHOOK_URL
  

  如果Flask日志没有输出"收到Webhook请求"，说明请求根本没到达服务，可能是：
  • 服务器防火墙/安全组未开放8443端口
  • WEBHOOK_URL填写错误（比如Make提供的URL带有路径后缀，而Flask路由是根路径"/"）
  • 服务未使用HTTPS（Telegram要求Webhook必须用HTTPS，本地测试可借助ngrok等工具暴露公网HTTPS地址）

二、检查日志输出完整性 #

• 代码中已设置logging.DEBUG，但需确保Flask自身日志也能输出：添加app.logger.setLevel(logging.DEBUG)到Flask对象创建后
• 在Webhook处理函数中增加更详细的日志，比如打印解析后的Update对象，确认是否能正确获取到消息或回调查询

三、验证Bot Token有效性 #

• 在启动代码中增加bot.get_me()调用，检查是否能成功获取Bot信息。如果调用失败，说明Token错误或网络问题导致无法连接Telegram API

四、排查服务监听与端口 #

• 确认8443端口未被其他程序占用：用netstat -tulpn | grep 8443（Linux）或netstat -ano | findstr :8443（Windows）检查
• 确认host='0.0.0.0'配置正确，允许外部访问；本地测试时需用工具暴露公网端口

五、代码潜在问题修复 #

• 时区函数异常捕获：get_user_timezone函数未处理异常，若出现错误会导致请求中断，需添加try-except捕获并打日志
• Webhook异常处理：在Webhook路由中增加全局异常捕获，避免未处理的错误导致Telegram重试或无响应

优化后的代码示例 #

import telebot
from telebot.types import InlineKeyboardButton, InlineKeyboardMarkup, CallbackQuery
import logging
from datetime import datetime, timezone
from flask import Flask, request, abort

# 配置日志
logging.basicConfig(
    format='%(asctime)s - %(name)s - %(levelname)s - %(message)s',
    level=logging.DEBUG
)
logger = logging.getLogger(__name__)

TOKEN = "YOUR_BOT_TOKEN"
WEBHOOK_URL = "YOUR_WEBHOOK_URL"

bot = telebot.TeleBot(TOKEN)

# /start命令处理器
@bot.message_handler(commands=['start'])
def send_welcome(message):
    logger.info(f"收到用户{message.from_user.id}的/start命令")

    keyboard = InlineKeyboardMarkup()
    keyboard.add(InlineKeyboardButton("选择时间", callback_data='choose_time'))

    bot.send_message(
        message.chat.id,
        "你好！这个Bot每天会给你发送一个单词和释义。请选择你方便接收的时间！",
        reply_markup=keyboard
    )

# 获取用户时区（增加异常处理）
def get_user_timezone(message):
    try:
        utc_time = datetime.fromtimestamp(message.date, tz=timezone.utc)
        user_time = utc_time.astimezone()
        offset_seconds = user_time.utcoffset().total_seconds()
        offset_hours = int(offset_seconds // 3600)
        return f"UTC{'+' if offset_hours >= 0 else ''}{offset_hours}"
    except Exception as e:
        logger.error(f"获取用户时区失败：{str(e)}")
        return "UTC+0"

# 内联按钮处理器
@bot.callback_query_handler(func=lambda call: True)
def callback_query(call: CallbackQuery):
    logger.info(f"按钮回调数据：{call.data}")

    if call.data == 'choose_time':
        keyboard = InlineKeyboardMarkup()
        keyboard.add(InlineKeyboardButton("早晨", callback_data='morning'))
        keyboard.add(InlineKeyboardButton("下午", callback_data='afternoon'))
        keyboard.add(InlineKeyboardButton("晚上", callback_data='evening'))
        keyboard.add(InlineKeyboardButton("深夜", callback_data='night'))
        bot.edit_message_text(
            chat_id=call.message.chat.id,
            message_id=call.message.message_id,
            text="选择时间段：",
            reply_markup=keyboard
        )

    elif call.data in ['morning', 'afternoon', 'evening', 'night']:
        times = {
            'morning': ["06:00", "07:00", "08:00", "09:00", "10:00", "11:00"],
            'afternoon': ["12:00", "13:00", "14:00", "15:00", "16:00", "17:00"],
            'evening': ["18:00", "19:00", "20:00", "21:00", "22:00", "23:00"],
            'night': ["00:00", "01:00", "02:00", "03:00", "04:00", "05:00"]
        }
        chosen_times = times[call.data]
        keyboard = InlineKeyboardMarkup()
        for time in chosen_times:
            keyboard.add(InlineKeyboardButton(time, callback_data=f"time_{time}"))
        bot.edit_message_text(
            chat_id=call.message.chat.id,
            message_id=call.message.message_id,
            text="选择具体时间：",
            reply_markup=keyboard
        )

    elif call.data.startswith('time_'):
        chosen_time = call.data.split('_')[1]
        user_timezone = get_user_timezone(call.message)
        bot.edit_message_text(
            chat_id=call.message.chat.id,
            message_id=call.message.message_id,
            text=f"你选择了{chosen_time}，时区{user_timezone}"
        )

# Flask服务配置
app = Flask(__name__)
app.logger.setLevel(logging.DEBUG)  # 开启Flask日志

# Webhook路由（增加全局异常处理）
@app.route("/", methods=['POST'])
def webhook():
    logger.info("收到Webhook请求")
    logger.info(f"请求头：{request.headers}")
    
    try:
        if request.headers.get('content-type') == 'application/json':
            json_string = request.get_data().decode('utf-8')
            logger.debug(f"收到的JSON数据：{json_string}")
            update = telebot.types.Update.de_json(json_string)
            logger.info(f"解析后的Update - ID: {update.update_id}, 消息: {update.message}, 回调查询: {update.callback_query}")
            bot.process_new_updates([update])
            logger.info("Update处理完成")
            return 'OK', 200
        else:
            logger.warning(f"无效的Content-Type：{request.headers.get('content-type')}")
            abort(400)
    except Exception as e:
        logger.error(f"处理Webhook请求失败：{str(e)}", exc_info=True)
        return 'Error', 500

# 启动服务
if __name__ == '__main__':
    try:
        bot.remove_webhook()
        bot.set_webhook(url=WEBHOOK_URL)
        webhook_info = bot.get_webhook_info()
        logger.info(f"Webhook信息：{webhook_info}")
        
        # 验证Token有效性
        bot_info = bot.get_me()
        logger.info(f"Bot信息：{bot_info}")

        logger.info("Webhook已设置，Bot启动完成")
        app.run(host='0.0.0.0', port=8443)
    except Exception as e:
        logger.error(f"Bot启动失败：{str(e)}", exc_info=True)

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