部署服务器后Flask Telegram Bot无响应问题求助

一、本地未设置Webhook也能运行的原因 #

你本地运行时实际用的是**长轮询（Long Polling）**模式，而非Webhook。这种模式下，程序会通过Bot Token持续调用Telegram的getUpdates接口，主动拉取未处理的消息，不需要暴露公网端口，也不需要Telegram主动推送，所以仅靠Token就能工作。如果当前代码没有轮询逻辑，大概率是测试时启用了轮询，而非依赖Webhook的被动推送。

二、服务器部署无响应的排查与解决步骤 #

1. 验证Webhook配置正确性 #

先调用接口查看Webhook状态，这是排查核心：

curl https://api.telegram.org/bot<你的TOKEN>/getWebhookInfo

重点看last_error_message字段，它会直接告知Telegram推送失败的具体原因（比如证书无效、连接超时、URL格式错误等）。

设置Webhook时必须上传公钥证书，否则Telegram无法信任你的服务器，正确命令如下：

curl -F "url=https://xxx.xx.xxx.xxx:8443/" -F "certificate=@path/cert.pem" https://api.telegram.org/bot<你的TOKEN>/setWebhook

注意：

• URL必须以https://开头，仅允许使用443、80、88、8443端口
• URL末尾的斜杠需与Flask路由@app.route('/')对应
• 必须上传你的公钥证书文件（cert.pem）

2. 确认端口与网络可达性 #

• 除了执行sudo ufw allow 8443，务必检查云服务器的安全组配置，确保8443端口的入站规则已开放，允许外部IP访问。
• 用外部工具测试Webhook地址是否可访问：

# 从本地或其他机器发起测试请求
curl -X POST https://xxx.xx.xxx.xxx:8443/ -d '{"message":{"chat":{"id":123},"text":"test"}}' -H "Content-Type: application/json"

若返回ok则服务正常；若连接超时或报错，说明网络层面存在拦截。

3. 修复代码中的潜在问题 #

（1）添加异常处理，避免服务崩溃

Telegram推送的消息不一定都包含message字段（如回调查询、频道通知等），直接解析会触发KeyError，导致返回500错误，Telegram会停止推送：

@app.route('/', methods=['GET', 'POST'])
def index():
    if request.method == 'POST':
        try:
            msg = request.get_json()
            # 跳过非普通消息类型
            if 'message' not in msg:
                return Response('ok', status=200)
            chat_id, txt = parse_message(msg)
            if txt == "hi":
                tel_send_message(chat_id, "Hello!!")
            else:
                tel_send_message(chat_id, 'from webhook')
        except Exception as e:
            print(f"处理请求出错: {e}")
        # 无论结果如何都返回200，告知Telegram消息已接收
        return Response('ok', status=200)
    else:
        return "<h1>Welcome!</h1>"

（2）优化响应速度，避免超时

Telegram要求Webhook必须在5秒内返回响应，同步调用tel_send_message可能超时，建议先返回响应再异步处理消息：

from threading import Thread

@app.route('/', methods=['GET', 'POST'])
def index():
    if request.method == 'POST':
        # 启动线程处理消息，立即返回响应
        Thread(target=handle_message, args=(request.get_json(),)).start()
        return Response('ok', status=200)
    else:
        return "<h1>Welcome!</h1>"

def handle_message(msg):
    try:
        if 'message' not in msg:
            return
        chat_id, txt = parse_message(msg)
        if txt == "hi":
            tel_send_message(chat_id, "Hello!!")
        else:
            tel_send_message(chat_id, 'from webhook')
    except Exception as e:
        print(f"处理消息出错: {e}")

（3）验证SSL证书路径与有效性

确保证书路径正确，且证书已上传给Telegram：

import os
# 启动前检查证书文件是否存在
print("证书路径有效:", os.path.exists('path/cert.pem'))
print("私钥路径有效:", os.path.exists('path/privkey.pem'))

4. 替换Flask开发服务器（生产环境建议） #

Flask自带的开发服务器不适合生产环境，建议用Gunicorn运行：

# 安装Gunicorn
pip install gunicorn
# 启动服务，指定SSL证书
gunicorn --bind 0.0.0.0:8443 --certfile=path/cert.pem --keyfile=path/privkey.pem main:app

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