如何通过Telethon获取Telegram私有频道消息？现有代码仅支持公开频道

核心前提 #

你的Telegram账号必须是目标私有频道的成员，否则无法获取任何内容——私有频道的权限机制就是如此，非成员无法访问。

问题排查与修复步骤 #

• 确认频道实体获取方式
  直接传入数字ID可能无法正确解析私有频道实体，建议尝试以下方式获取实体：

  1. 如果频道有自定义用户名（即使是私有），用await client.get_entity("username")替代数字ID；
  2. 如果只有邀请链接，提取链接中joinchat/后的哈希部分，用await client.get_entity("哈希字符串")；
  3. 确保客户端已缓存该频道：先通过官方Telegram客户端加入频道，再运行代码，避免因本地无缓存导致解析失败。

• 处理权限与异常
  私有频道访问时常见权限错误，需针对性捕获：

  • PeerIdInvalidError：实体解析失败，检查ID/用户名是否正确；
  • ChatWriteForbiddenError/ChatAdminRequiredError：账号无权限访问该频道，确认是否为成员；
  • FloodWaitError：请求频率过高，需添加等待逻辑。

• 代码优化（修复版）

async def read_chat_by_id(chat_identifier, limit):
    try:
        # 复用客户端连接，避免重复start/disconnect
        if not client.is_connected():
            await client.start(PHONE_NUMBER)

        # 支持多种标识符：数字ID、用户名、邀请哈希
        entity = await client.get_entity(chat_identifier)

        messages = await client.get_messages(entity, limit=limit)

        for message in messages:
            # 处理频道消息可能无from_id的情况
            sender_id = message.from_id.user_id if hasattr(message.from_id, 'user_id') else "Channel"
            print(f"Message ID: {message.id}, From: {sender_id}, Text: {message.message or '无文本内容'}")

    except PeerIdInvalidError:
        print("无法解析频道实体，请检查ID/用户名/邀请哈希是否正确，或确认账号已加入频道")
    except ChatWriteForbiddenError:
        print("账号无权限访问该私有频道，请确认是否为频道成员")
    except FloodWaitError as e:
        print(f"请求过于频繁，请等待{e.seconds}秒后重试")
    except Exception as e:
        print(f"未知错误: {str(e)}")
    finally:
        if client.is_connected():
            await client.disconnect()

额外提示 #

• 不要频繁调用client.start()，建议在程序初始化时启动一次客户端，结束时再断开；
• 私有频道的消息可能包含媒体（图片/视频），如果需要处理，可检查message.media属性；
• 如果使用的是Telethon库，确保版本为最新，旧版本可能存在实体解析的bug。

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