Node.js下Telegraf的text与photo消息监听器无法同时工作如何解决

在Telegraf框架中，消息监听器默认会在匹配并处理后终止中间件链的传递——如果一条消息同时匹配多个监听器（比如带文字说明的图片消息会同时触发text和photo过滤器），只有第一个匹配的监听器会执行，后续的会被跳过。要让两个监听器同时生效，只需在每个监听器的处理函数中调用next()方法即可：

import { Telegraf } from 'telegraf';
import { message } from 'telegraf/filters';

const bot = new Telegraf('YOUR_BOT_TOKEN');

bot.on(message('text'), async (ctx, next) => {
  // 处理文本消息的逻辑
  console.log('收到文本:', ctx.message.text);
  await next(); // 调用next()让后续监听器继续处理
});

bot.on(message('photo'), async (ctx, next) => {
  // 处理图片消息的逻辑
  console.log('收到图片:', ctx.message.photo);
  await next(); // 若有更多监听器，可继续传递
});

bot.launch();

关键说明： #

• next()是Telegraf中间件机制的核心，调用它会让当前消息继续流经后续的中间件/监听器。
• 如果你的场景是不同类型的消息分别触发对应监听器（纯文本只触发text监听器，纯图片只触发photo监听器），但依然无法生效，需要排查以下问题：
  • 某个监听器内部抛出未捕获的错误，导致后续逻辑终止；
  • 错误使用ctx.stopPropagation()或类似方法终止了中间件链；
  • 框架版本过低存在过滤器匹配bug，建议升级到最新版Telegraf。

内容的提问来源于stack exchange，提问作者Juan Carlos Campbell