Aiogram 3.4.1 中 answer_media_group() 不支持直接传入 caption 或 text 参数，需使用 MediaGroupBuilder 构建带统一标题的媒体组，才能为多张图片添加共享说明文字。

aiogram 3.4.1 中 `answer_media_group()` 不支持直接传入 `caption` 或 `text` 参数，需使用 `mediagroupbuilder` 构建带统一标题的媒体组，才能为多张图片添加共享说明文字。

在 Aiogram 3.x（尤其是 3.4.1 及以上版本）中，message.answer_media_group() 方法已移除对 caption 和 text 参数的支持——这是与旧版 Aiogram 2.x 的关键差异。若你尝试像这样调用：

await message.answer_media_group(group, caption="Text123")  # ❌ 无效！会报错或被忽略

该 caption 将被静默忽略，因为 answer_media_group() 的签名仅接受 media（即 Sequence[InputMedia]）和基础参数（如 reply_markup, disable_notification），不再接受全局标题。

✅ 正确做法是：使用 aiogram.utils.media_group.MediaGroupBuilder —— 它专为构建带统一标题的媒体组而设计，并自动为所有媒体项（除首张外）设置空 caption，确保 Telegram 客户端将标题仅显示在第一张图上方，符合官方行为规范。

✅ 正确实现步骤

1. 导入构建器

   

   QuiverAI

   QuiverAI是一款AI图像与设计工具，AI矢量图形生成工具，输出可编辑的 SVG 代码。

   下载

   from aiogram.utils.media_group import MediaGroupBuilder

2. 初始化并设置统一标题
   MediaGroupBuilder(caption=...) 接收一个字符串作为整个媒体组的共享标题（仅对首张媒体生效）：

   media_group = MediaGroupBuilder(caption="✨ 我的旅行瞬间 · 共5张照片")

3. 逐个添加图片（推荐使用 file_id）
   若用户发送的是多张照片（如通过相册上传），message.photo 是一个按分辨率排序的 list[PhotoSize]，通常取最后一个（即最高清）的 file_id：

   # 示例：从消息中提取所有照片 file_id（取每个 PhotoSize 的 file_id）
   photo_ids = [photo.file_id for photo in message.photo]
   for file_id in photo_ids:
       media_group.add_photo(media=file_id)

   ? 提示：add_photo() 默认 type="photo"，可简写；如需指定类型（如 input_file），也可传入 InputFile 实例。

4. 发送媒体组
   调用 build() 获取 List[InputMedia]，再传给 answer_media_group：

   await message.answer_media_group(media=media_group.build())

? 完整可运行示例

from aiogram import Router
from aiogram.types import Message
from aiogram.utils.media_group import MediaGroupBuilder

router = Router()

@router.message(lambda m: len(m.photo) > 1)  # 捕获含多图的消息
async def handle_photo_album(message: Message):
    # 构建带标题的媒体组
    builder = MediaGroupBuilder(
        caption="? 这是一组精选照片\n?拍摄于2024年夏"
    )

    # 添加每张照片（使用最高分辨率 file_id）
    for photo in message.photo:
        builder.add_photo(media=photo.file_id)

    # 发送
    await message.answer_media_group(media=builder.build())

⚠️ 注意事项

• 标题仅显示在第一张图上：这是 Telegram 官方客户端行为，不可更改；后续图片无标题，但属于同一媒体组。
• 不支持混合媒体类型带统一标题：若同时添加 photo 和 video，caption 仅对首个媒体项生效（且必须匹配其类型），建议同类型媒体分组发送。
• 避免重复 caption：不要在 add_photo(media=..., caption=...) 中单独设 caption，否则会覆盖 MediaGroupBuilder 的全局 caption。
• 文件大小限制：单张图 ≤ 10 MB，整个媒体组无额外限制，但建议总大小控制在合理范围以保证兼容性。

通过 MediaGroupBuilder，你不仅能优雅解决“多图+统一标题”问题，还能获得更好的类型安全与可维护性——这是 Aiogram 3 推荐的标准实践。