Telegram Bot CallbackQuery无法触发onUpdateReceived问题求助

问题背景 #

我正在用Java（基于TelegramBotsApi v6.7.0的Maven项目）开发Telegram Bot，需要创建Inline Keyboard Markup并处理用户的CallbackQuery来执行后续逻辑。

Inline Keyboard 实现代码 #

private InlineKeyboardMarkup createMenuMarkup() {
    List<List<InlineKeyboardButton>> inlineButtons = new ArrayList<>();
    List<InlineKeyboardButton> inlineKeyboardButtonList1 = new ArrayList<>();
    List<InlineKeyboardButton> inlineKeyboardButtonList2 = new ArrayList<>();

    InlineKeyboardButton inlineKeyboardButton1 = InlineKeyboardButton.builder()
            .text("Choice 1")
            .callbackData("1")
            .url("https://www.google.com")
            .build();

    InlineKeyboardButton inlineKeyboardButton2 = InlineKeyboardButton.builder()
            .text("Choice 2")
            .callbackData("2")
            .build();

    InlineKeyboardButton inlineKeyboardButton3 = InlineKeyboardButton.builder()
            .text("Choice 3")
            .callbackData("3")
            .build();
    InlineKeyboardButton inlineKeyboardButton4 = InlineKeyboardButton.builder()
            .text("Choice 4")
            .callbackData("4")
            .build();

    inlineKeyboardButtonList1.add(inlineKeyboardButton1);
    inlineKeyboardButtonList1.add(inlineKeyboardButton2);
    inlineKeyboardButtonList2.add(inlineKeyboardButton3);
    inlineKeyboardButtonList2.add(inlineKeyboardButton4);
    inlineButtons.add(inlineKeyboardButtonList1);
    inlineButtons.add(inlineKeyboardButtonList2);

    return InlineKeyboardMarkup
            .builder()
            .keyboard(inlineButtons)
            .build();
}

回调处理代码 #

else if(update.getMessage().getText().equals("/menu"))
{
    sendMarkup(createMenuMarkup());
}
else if(update.hasCallbackQuery())
{
    System.out.println("Callback Received");
    handleCallback(update);
}

private void handleCallback(Update update)
{
    String callData = update.getCallbackQuery().getData();
    System.out.println(callData);
    switch (callData)
    {
        case "1":
            sendMessage("You chose 1");
            break;
        case "2":
            sendMessage("You chose 2");
            break;
        case "3":
            sendMessage("You chose 3");
            break;
        case "4":
            sendMessage("You chose 4");
            break;
        default:
            break;
    }
}

问题现象 #

点击Inline按钮后，CallbackQuery完全不被识别为update，无法进入onUpdateReceived的回调处理逻辑。切换到v5.4.0版本问题依然存在，但ReplyKeyboardMarkup的按钮功能正常。

解决方案 #

1. 修复按钮参数冲突 #

InlineKeyboardButton不能同时设置url和callbackData——当同时配置这两个参数时，Telegram客户端会优先触发URL跳转逻辑，不会发送CallbackQuery。删除按钮1的url配置：

InlineKeyboardButton inlineKeyboardButton1 = InlineKeyboardButton.builder()
        .text("Choice 1")
        .callbackData("1")
        // 移除.url("https://www.google.com")这一行
        .build();

2. 调整更新处理逻辑顺序 #

当前代码先判断update.getMessage()，如果是CallbackQuery类型的更新，update.getMessage()会返回null，若前面的分支逻辑处理不当，可能会跳过回调判断。优先处理非消息类型的更新：

@Override
public void onUpdateReceived(Update update) {
    // 先处理CallbackQuery
    if (update.hasCallbackQuery()) {
        System.out.println("Callback Received");
        handleCallback(update);
        return; // 处理完直接返回，避免后续逻辑干扰
    }
    // 再处理文本消息
    if (update.hasMessage() && update.getMessage().hasText()) {
        String text = update.getMessage().getText();
        if (text.equals("/menu")) {
            sendMarkup(createMenuMarkup());
        }
        // 其他消息处理逻辑
    }
}

3. 排查Bot的更新接收配置 #

• 若使用Webhook模式：确认Webhook地址正确、可被Telegram服务器访问，且SSL证书配置正常
• 若使用长轮询（GetUpdates）模式：确认Bot权限配置正确，没有被防火墙/代理拦截请求

可以先打印所有更新内容，确认是否收到CallbackQuery：

@Override
public void onUpdateReceived(Update update) {
    // 打印完整更新日志，排查是否收到回调
    System.out.println("Received update: " + update.toString());
    // 后续处理逻辑...
}

4. 补充CallbackQuery的强制回复 #

Telegram要求Bot必须回复CallbackQuery，否则客户端会一直显示加载状态，也可能导致后续回调异常。在handleCallback中添加回复逻辑：

private void handleCallback(Update update) {
    CallbackQuery callbackQuery = update.getCallbackQuery();
    String callData = callbackQuery.getData();
    System.out.println(callData);
    
    // 必须回复CallbackQuery
    AnswerCallbackQuery answer = AnswerCallbackQuery.builder()
            .callbackQueryId(callbackQuery.getId())
            .text("已处理你的选择") // 可选提示文本，可设为空
            .build();
    try {
        execute(answer);
    } catch (TelegramApiException e) {
        e.printStackTrace();
    }

    switch (callData) {
        case "1":
            sendMessage("You chose 1");
            break;
        case "2":
            sendMessage("You chose 2");
            break;
        case "3":
            sendMessage("You chose 3");
            break;
        case "4":
            sendMessage("You chose 4");
            break;
        default:
            break;
    }
}

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