使用MadelineProto监听Telegram新订阅事件失败问题排查

开发者阿泽

2026-8-3

问题分析与解决方案

你的代码无法监听到新用户订阅事件，主要有以下几个可能的原因和对应的解决办法：

1. 事件方法名错误

Telegram里单个用户加入/离开频道/群的更新类型是UpdateChatParticipant，而非UpdateChatParticipants（后者仅对应批量成员变动的极端场景，几乎不会触发）。你需要修改事件处理方法的名称：

public function onUpdateChatParticipant(array $update)
{
    print_r(__METHOD__);
    yield print_r($update);
}

2. 机器人权限不足

机器人必须是目标频道/超级群的管理员，并且要开启查看成员的权限（在频道设置的管理员权限列表里勾选）。没有这个权限的话，Telegram服务器根本不会给机器人推送成员变动的更新。

3. 未配置MadelineProto接收成员更新

默认情况下，MadelineProto可能不会主动接收成员变动类的更新，需要在Settings里明确指定允许接收的更新类型：

$settings = new Settings();
// 保留原有AppInfo配置代码
$appInfo = new Settings\AppInfo();
$appInfo->setApiHash(config('telegram.app.app_info.api_hash'))
->setApiId(config('telegram.app.app_info.api_id'));
$settings->setAppInfo($appInfo);

// 添加更新配置
$updateSettings = new Settings\Updates();
$updateSettings->setAllowedUpdates(['chat_participant', 'channel_post', 'message']);
$settings->setUpdates($updateSettings);

$api = new API(time(), $settings);