You need to enable JavaScript to run this app. C#开发Telegram机器人时如何实现register_next_step_handler及解决状态占用问题
优惠活动
大模型
产品
解决方案
定价
更多

C#开发Telegram机器人时如何实现register_next_step_handler及解决状态占用问题

C# Telegram Bot 实现「捕获用户下一条输入消息」方案

原有全局变量方案的核心缺陷是无用户隔离、无状态生命周期管理,天然不支持多用户并发使用,也无法处理用户触发后不响应的残留状态问题。
正确实现思路如下:

  • 按 ChatId为唯一标识 做用户维度的状态隔离,不使用全局共享变量
  • 为每个待捕获状态绑定有效期、对应的处理逻辑,处理完/过期后自动清除
  • 使用线程安全的存储结构处理多线程回调的并发问题

1. 定义状态模型与线程安全存储

首先定义单用户的待处理状态结构,以及全局的状态存储容器:

using System.Collections.Concurrent;

// 单个用户的待处理状态
public class PendingUserState
{
    // 状态过期时间
    public DateTime ExpireTime { get; set; }
    // 下一条消息的处理逻辑委托
    public Action<Message> NextStepAction { get; set; }
}

// 类内声明线程安全的状态存储,Key为ChatId
private readonly ConcurrentDictionary<long, PendingUserState> _pendingStates = new ConcurrentDictionary<long, PendingUserState>();

2. 触发待捕获逻辑时登记状态

在用户触发需要等待输入的命令/回调时,为对应用户登记待处理状态,而非修改全局变量:

// 示例:用户触发需要输入内容的命令时的处理逻辑
private async Task OnInputRequestCommand(Message msg)
{
    // 先向用户发送输入提示
    await Bot.SendTextMessageAsync(msg.Chat.Id, "请输入需要的内容:");

    // 登记10分钟有效期的待处理状态
    _pendingStates.TryAdd(msg.Chat.Id, new PendingUserState
    {
        ExpireTime = DateTime.Now.AddMinutes(10),
        NextStepAction = (message) =>
        {
            // 此处写下一条消息需要执行的业务逻辑
            Bot.SendTextMessageAsync(message.Chat.Id, $"你输入的内容是:{message.Text}");
        }
    });
}

3. 统一消息入口做状态判断

在所有消息的统一接收处理逻辑中,优先判断当前用户是否存在待处理状态:

private async Task OnAllMessagesReceived(Message msg)
{
    long currentChatId = msg.Chat.Id;

    // 尝试获取当前用户的待处理状态
    if (_pendingStates.TryGetValue(currentChatId, out var pendingState))
    {
        // 状态已过期则直接清除,提示用户重新触发
        if (DateTime.Now > pendingState.ExpireTime)
        {
            _pendingStates.TryRemove(currentChatId, out _);
            await Bot.SendTextMessageAsync(currentChatId, "输入超时,请重新触发对应命令");
            return;
        }

        // 执行预定义的下一条消息处理逻辑
        pendingState.NextStepAction.Invoke(msg);

        // 处理完成后立刻清除状态,避免后续消息被误捕获
        _pendingStates.TryRemove(currentChatId, out _);
        return;
    }

    // 无待处理状态时,走正常的普通命令分发逻辑
}

可选优化点

  • 增加后台定时任务,每隔固定时间扫描_pendingStates,自动清除所有过期状态,避免内存占用
  • 如果使用依赖注入框架,将状态存储容器注册为单例服务,无需手动维护全局变量
  • 复杂多轮对话场景可替换为状态机实现,支持自动流转多步输入流程

内容的提问来源于stack exchange,提问作者Snail

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.11 13:54:09