Telethon 异步编程指南：正确获取用户信息与协程处理-Python教程-PHP中文网

Telethon 异步编程指南：正确获取用户信息与协程处理

心靈之曲

发布： 2025-11-20 13:05:43

原创

228人浏览过

Telethon 异步编程指南：正确获取用户信息与协程处理

在使用 telethon 库开发 telegram 客户端时，尝试获取自身信息（如 `client.get_me()`）时，常会遇到 `attributeerror: 'coroutine' object has no attribute 'stringify'` 错误。这通常是因为 telethon 的大部分方法都是异步协程，需要使用 python 的 `await` 关键字来等待其执行结果，而不是直接调用其属性。本文将详细阐述此问题的成因，并提供一个使用 `async/await` 语法和 `asyncio` 模块来正确处理异步操作并获取用户信息的完整教程。

理解 Telethon 的异步特性

Telethon 是一个基于 Python 的 Telegram API 客户端库，它充分利用了 Python 的异步编程能力（asyncio 模块）。这意味着库中的许多操作，尤其是那些涉及网络请求或长时间等待的操作，都被设计为协程（coroutine）。当您调用一个协程函数时，它不会立即返回最终结果，而是返回一个“协程对象”，这个对象代表了未来某个时刻可能完成的操作。

错误分析：AttributeError: 'coroutine' object has no attribute 'stringify'

当您执行以下代码时：

from telethon import TelegramClient

api_id = my_id
api_hash = 'my_hash'

client = TelegramClient('Test2Session', api_id, api_hash)
client.start() # 注意：这里也需要 await

print(client.get_me().stringify())

登录后复制

client.get_me() 返回的不是一个用户对象，而是一个协程对象。这个协程对象本身并没有 stringify 方法。因此，尝试直接在其上调用 stringify() 会导致 AttributeError。正确的做法是“等待”这个协程完成执行，从而获取到它最终返回的用户对象。

解决方案：使用 async/await 处理协程

要正确地处理 Telethon 的异步方法，您需要将您的代码封装在一个异步函数中，并使用 await 关键字来等待协程的执行结果。

核心概念

async def: 用于定义一个异步函数（协程函数）。
await: 用于暂停当前异步函数的执行，直到它等待的协程完成并返回结果。
asyncio.run(): 这是 asyncio 模块提供的一个顶级函数，用于运行一个异步入口点。它会负责启动事件循环，运行您的主协程，并在协程完成后关闭事件循环。

示例代码：正确获取用户信息

以下是修复后的代码示例，它演示了如何正确地初始化 Telethon 客户端、启动会话，并获取自身用户信息：

import asyncio
from telethon import TelegramClient

# 替换为您的实际 API ID 和 API Hash
api_id = 1234567 # 请替换为您的 Telegram API ID
api_hash = 'your_api_hash_here' # 请替换为您的 Telegram API Hash

async def main():
    """
    主异步函数，用于执行 Telethon 客户端操作。
    """
    # 创建 TelegramClient 实例
    # 'Test2Session' 是会话文件的名称，用于保存认证信息
    client = TelegramClient('Test2Session', api_id, api_hash)

    print("正在启动客户端...")
    # 启动客户端，这是一个异步操作，需要 await
    await client.start()
    print("客户端已启动。")

    print("正在获取自身信息...")
    # 获取自身用户信息，这是一个异步操作，需要 await
    # await 会等待 get_me() 协程完成，并返回一个 User 对象
    me = await client.get_me()
    print("自身信息获取成功。")

    # 现在 me 是一个 User 对象，可以安全地调用其方法
    print("自身用户信息详情：")
    print(me.stringify()) # User 对象有 stringify 方法

    # 示例：打印一些常用属性
    print(f"ID: {me.id}")
    print(f"用户名: {me.username}")
    print(f"名字: {me.first_name}")
    print(f"姓氏: {me.last_name}")
    print(f"电话号码: {me.phone}")

    # 完成操作后，断开客户端连接
    print("正在断开客户端连接...")
    await client.disconnect()
    print("客户端已断开。")

if __name__ == '__main__':
    # 使用 asyncio.run() 运行主异步函数
    # 这是启动 asyncio 事件循环并运行协程的推荐方式
    asyncio.run(main())

登录后复制

代码解析

import asyncio: 导入 Python 的异步 I/O 模块。
async def main():: 定义了一个名为 main 的异步函数，所有的 Telethon 异步操作都将在这个函数中进行。
await client.start(): client.start() 是一个协程，用于连接到 Telegram 服务器并进行认证。必须使用 await 来等待其完成。
me = await client.get_me(): client.get_me() 也是一个协程，它会向 Telegram 请求当前用户的信息。await 关键字会暂停 main 函数的执行，直到 get_me() 返回一个 User 对象。
print(me.stringify()): 一旦 me 变量被赋值为实际的 User 对象，您就可以安全地调用其 stringify() 方法或其他属性。
if __name__ == '__main__': asyncio.run(main()): 这是标准的 Python 异步程序的入口点。asyncio.run(main()) 会启动一个事件循环，运行 main() 协程，并在 main() 协程完成后关闭事件循环。

注意事项与最佳实践

几乎所有 Telethon 方法都是协程：请记住，在 Telethon 中，凡是涉及与 Telegram 服务器交互的方法（如发送消息、获取对话、加入频道等）几乎都是协程，都需要使用 await。

Logome
AI驱动的Logo生成工具

133

查看详情
异常处理：在实际应用中，您应该为异步操作添加 try...except 块来处理可能发生的网络错误或其他异常。
会话管理：TelegramClient('Test2Session', ...) 中的 'Test2Session' 指定了会话文件的名称。这个文件会保存您的认证信息，使得下次运行程序时无需重新登录。请妥善保管这些会话文件。

异步上下文管理器：Telethon 的 TelegramClient 也支持异步上下文管理器，可以更优雅地管理客户端的连接和断开：

async def main_with_context_manager():
    async with TelegramClient('Test2Session', api_id, api_hash) as client:
        print("客户端已启动。")
        me = await client.get_me()
        print(me.stringify())
    print("客户端已断开。") # 退出 with 块时自动断开

登录后复制

调试异步代码：调试异步代码可能需要一些习惯。确保您的调试器支持 asyncio。

总结

AttributeError: 'coroutine' object has no attribute 'stringify' 错误是 Telethon 初学者常遇到的问题，其根本原因在于未能正确理解和使用 Python 的异步编程模型。通过将 Telethon 操作封装在 async 函数中，并使用 await 关键字等待协程的执行结果，您可以有效地解决此问题，并充分利用 Telethon 库的强大功能来构建高效、响应迅速的 Telegram 客户端。掌握 async/await 和 asyncio 是使用 Telethon 进行开发的基石。

以上就是Telethon 异步编程指南：正确获取用户信息与协程处理的详细内容，更多请关注php中文网其它相关文章！