如何在python-telegram-bot中点击InlineKeyboardButton时为消息添加图片

核心问题答复 #

• 点击InlineKeyboardButton时可以为消息添加图片，但不能使用edit_message_text方法，需改用edit_message_media来替换消息的媒体内容。
• 可以清除消息附件，同样通过edit_message_media将原媒体替换为纯文本媒体对象即可。

代码修改示例 #

1. 导入所需媒体类 #

先确保导入Telegram Bot API的媒体输入类：

from telegram import InputMediaPhoto, InputMediaText, ParseMode

2. 修改product_view函数 #

根据产品是否存在图片，选择对应媒体类型更新消息：

async def product_view(
    update: Update, context: ContextTypes.DEFAULT_TYPE, data: dict[str, any]
):
    """Product view"""
    query = update.callback_query

    product_slug = data["product"]
    product = await api.get.product(product_slug)

    text = f"<b>{product.name}</b>\n{product.description}"  # 示例富文本描述
    keyboard = [
        [
            InlineKeyboardButton(
                text="加入购物车",
                callback_data=generate_button_callback_data(
                    MenuStates.EMPTY_ACTION,
                )
            )
        ],
        [
            InlineKeyboardButton(
                text="返回分类",
                callback_data=generate_button_callback_data(
                    state=MenuStates.CATEGORIES_SELECT
                )
            )
        ]
    ]
    reply_markup = InlineKeyboardMarkup(keyboard)

    try:
        # 判断产品是否有有效图片URL
        if hasattr(product, 'image_url') and product.image_url:
            # 替换为带图片的消息
            media = InputMediaPhoto(
                media=product.image_url,
                caption=text,
                parse_mode=ParseMode.HTML
            )
            await query.edit_message_media(media=media, reply_markup=reply_markup)
        else:
            # 显示纯文本消息（清除现有附件）
            media = InputMediaText(
                message_text=text,
                parse_mode=ParseMode.HTML
            )
            await query.edit_message_media(media=media, reply_markup=reply_markup)
    except Exception as e:
        # 媒体加载失败时降级为纯文本更新
        await query.edit_message_text(
            text=text,
            reply_markup=reply_markup,
            parse_mode=ParseMode.HTML
        )
        logging.error(f"媒体更新失败: {str(e)}", exc_info=True)

关键注意事项 #

• edit_message_media允许在纯文本消息和带媒体的消息之间自由切换，无需匹配原消息媒体类型。
• 若使用本地图片文件，需传入open(file_path, 'rb')作为media参数，并确保机器人有文件读取权限。
• 清除附件本质是将原媒体替换为纯文本媒体对象，无需额外调用其他方法。
• 必须处理媒体加载异常（如图片URL失效），避免机器人运行报错。

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