如何使用 Aiogram 构建 Telegram 频道消息自动转发机器人-Python教程-PHP中文网

如何使用 Aiogram 构建 Telegram 频道消息自动转发机器人

本文详解如何正确配置 aiogram 机器人，实现从一个 telegram 频道实时捕获并完整转发（含媒体、格式、链接等）消息至另一频道，重点解决过滤器不触发、消息静默丢失等常见问题。

本文详解如何正确配置 aiogram 机器人，实现从一个 telegram 频道实时捕获并完整转发（含媒体、格式、链接等）消息至另一频道，重点解决过滤器不触发、消息静默丢失等常见问题。

要让 Telegram 机器人成功监听并转发频道消息，需同时满足权限前提与代码逻辑正确性两个关键条件——而原代码失败的根本原因在于：Telegram 机器人无法通过普通 message 事件监听公开频道的新消息（除非是管理员或已加入该频道且消息为“提及机器人”）。

✅ 正确前提：确保机器人具备监听权限

机器人必须 以管理员身份添加到源频道（from_channel）；
源频道需为 公开频道（public） 或你拥有管理权限的私有频道；
在频道设置中启用 “允许管理员查看隐藏成员和消息”（Bot 需具备 can_read_messages 权限）；
⚠️ 重要：Telegram 不会向机器人推送非提及的普通频道消息 —— 即使是管理员，也必须启用「消息转发」权限（can_post_messages 不相关，关键是 can_read_messages + is_anonymous: false）；更可靠的方式是：将机器人设为频道管理员，并开启「匿名管理员」选项（即 is_anonymous = False），同时确保频道未禁用“管理员消息可见性”。

✅ 正确代码：使用 `copy_message` 并修复事件监听逻辑

原代码存在多个关键缺陷：

@dp.message(...) 无法捕获频道广播消息（channel post），应改用 @dp.channel_post；
send_message 会丢失图片、视频、按钮、格式等元数据，应统一使用 copy_message；
缺少错误处理与日志反馈，难以调试；
from_chanel 和 to_chanel 未做类型校验（需为整数 ID，如 -1001234567890）。

以下是修复后的完整可运行示例（基于 Aiogram 3.x）：

import asyncio
import logging
from aiogram import Bot, Dispatcher
from aiogram.filters import Filter
from aiogram.types import ChannelPost

# 配置日志便于调试
logging.basicConfig(level=logging.INFO)

# 替换为你的值
BOT_TOKEN = "YOUR_BOT_TOKEN"
SOURCE_CHANNEL_ID = -1001234567890  # 注意：必须是负数，且带 -100 前缀
TARGET_CHANNEL_ID = -1009876543210

bot = Bot(token=BOT_TOKEN)
dp = Dispatcher()

class IsSourceChannel(Filter):
    def __init__(self, channel_id: int):
        self.channel_id = channel_id

    async def __call__(self, message: ChannelPost) -> bool:
        return message.chat.id == self.channel_id

@dp.channel_post(IsSourceChannel(SOURCE_CHANNEL_ID))
async def forward_channel_post(message: ChannelPost):
    try:
        # 完整复制原始消息（保留所有内容类型：文本、图片、视频、文件、投票、链接预览等）
        await bot.copy_message(
            chat_id=TARGET_CHANNEL_ID,
            from_chat_id=message.chat.id,
            message_id=message.message_id,
            protect_content=False  # 可选：设为 True 防转发
        )
        logging.info(f"✅ 转发成功：消息 {message.message_id} → {TARGET_CHANNEL_ID}")
    except Exception as e:
        logging.error(f"❌ 转发失败：{e}")

async def main():
    logging.info("? 转发机器人已启动，监听频道...")
    await dp.start_polling(bot)

if __name__ == "__main__":
    asyncio.run(main())

? 关键说明与注意事项

✅ 必须使用 @dp.channel_post 而非 @dp.message：频道广播消息属于 ChannelPost 类型，不属于用户对话上下文；
✅ copy_message 是唯一能无损转发所有消息类型（图文、视频、文档、投票、服务消息等）的方法；
✅ SOURCE_CHANNEL_ID 必须为 整数形式的频道 ID（如 -1001234567890），可通过 @username_to_id_bot 查询；切勿使用 @channelname 字符串；
✅ 若目标频道为私有，请确保机器人已加入并拥有 can_post_messages 权限；
? 不要尝试监听“他人公开频道”——除非你拥有该频道管理权，否则违反 Telegram ToS 且技术上不可行。