Telethon异步编程：正确获取用户自身信息的指南-Python教程-PHP中文网

Telethon异步编程：正确获取用户自身信息的指南

碧海醫心

发布： 2025-11-21 10:42:06

原创

654人浏览过

Telethon异步编程：正确获取用户自身信息的指南

在使用telethon库获取telegram用户信息时，`client.get_me()`方法返回的是一个协程对象而非实际结果，直接调用`stringify()`会导致`attributeerror`。本教程将详细介绍如何通过python的`async/await`语法正确地异步等待协程结果，从而成功获取并处理用户自身信息，确保telethon客户端的稳定运行和数据获取的准确性。

Telethon与异步编程基础

Telethon是一个基于Python的Telegram客户端库，它设计之初就充分利用了Python的异步特性，特别是asyncio库。这意味着许多网络操作，如连接到Telegram服务器、发送消息或获取用户信息，都是非阻塞的。当调用一个异步函数（或协程）时，它不会立即返回最终结果，而是返回一个“协程对象”，这个对象表示一个未来会完成的操作。

理解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()

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

登录后复制

错误信息AttributeError: 'coroutine' object has no attribute 'stringify'表明client.get_me()的返回值是一个协程对象，而不是一个可以直接调用stringify()方法的实际用户对象。要获取协程的实际结果，需要使用Python的await关键字来“等待”协程完成并返回其结果。

正确获取用户信息的异步方法

为了解决这个问题，我们需要将代码结构调整为异步模式，使用async和await关键字。

DeepBrain

AI视频生成工具，ChatGPT +生成式视频AI =你可以制作伟大的视频!

查看详情

核心概念：async和await

async: 用于定义一个协程函数。只有在async函数内部，才能使用await关键字。
await: 用于暂停当前协程的执行，等待另一个协程完成并返回结果。当await一个协程时，程序控制权会交还给事件循环，允许其他任务运行，直到被等待的协程完成。

示例代码：获取并打印用户信息

以下是修正后的代码，它展示了如何正确地使用async/await来获取Telethon中的用户自身信息：

import asyncio
from telethon import TelegramClient

# 替换为你的API ID和API Hash
api_id = 1234567  # 你的API ID
api_hash = 'your_api_hash_here' # 你的API Hash

async def main():
    """
    主异步函数，用于初始化Telethon客户端并获取用户信息。
    """
    # 初始化TelegramClient
    # 'Test2Session' 是会话文件的名称，用于存储授权信息
    client = TelegramClient('Test2Session', api_id, api_hash)

    # 启动客户端。这是一个异步操作，需要await。
    # 如果是首次运行，会提示输入手机号和验证码。
    await client.start()

    print("客户端已成功连接。")

    # 获取当前用户自身的信息。这是一个异步操作，需要await。
    me = await client.get_me()

    # 打印用户信息的字符串表示
    print("成功获取到用户信息：")
    print(me.stringify())

    # 客户端操作完成后，通常会断开连接
    # await client.disconnect() # 如果需要断开连接，可以在这里添加

if __name__ == '__main__':
    # 运行主异步函数
    # asyncio.run() 是Python 3.7+ 运行顶层异步代码的推荐方式
    asyncio.run(main())

登录后复制

代码解析

import asyncio: 引入Python内置的异步I/O库，它是运行async/await代码的基础。
async def main():: 定义了一个名为main的异步函数。所有的Telethon异步操作都将在这个函数内部执行。
client = TelegramClient('Test2Session', api_id, api_hash): 初始化Telethon客户端。'Test2Session'是会话文件的名称，Telethon会将登录凭据保存在这个文件中，方便后续启动时自动登录。
await client.start(): 启动客户端。这个操作会尝试连接到Telegram服务器并进行认证。由于这是一个网络I/O操作，它是异步的，因此需要await。
me = await client.get_me(): 调用client.get_me()方法获取当前用户的信息。同样，这是一个异步操作，需要await来等待其完成并返回一个User对象（或其他相关对象），而不是一个协程对象。
print(me.stringify()): 一旦await client.get_me()完成并返回了User对象，我们就可以安全地调用其stringify()方法来获取格式化的字符串表示。
if __name__ == '__main__': asyncio.run(main()): 这是标准的Python惯用法，用于在脚本直接运行时执行main函数。asyncio.run(main())负责创建和管理事件循环，运行main协程，并在main协程完成后关闭事件循环。

注意事项与最佳实践

API ID和API Hash的安全性: 将api_id和api_hash直接硬编码在代码中并非最佳实践，尤其是在生产环境中。建议从环境变量、配置文件或安全密钥管理服务中加载它们。
会话管理: Telethon使用会话文件（如Test2Session.session）来存储登录凭据。首次运行需要输入手机号和验证码，之后会自动登录。请妥善保管这些会话文件，它们相当于你的Telegram登录凭证。
错误处理: 在实际应用中，应该添加适当的try...except块来处理可能发生的网络错误、认证失败或其他异常。
异步生态系统: 熟悉asyncio库对于使用Telethon至关重要。理解事件循环、任务、Future等概念将帮助你更好地构建复杂的异步应用。
资源释放: 对于长时间运行的客户端，你可能需要在应用程序关闭时调用await client.disconnect()来优雅地断开与Telegram服务器的连接，释放资源。

总结

Telethon作为一款强大的Telegram客户端库，其异步特性是其高效运行的基础。理解并正确运用Python的async/await语法是使用Telethon的关键。当遇到类似AttributeError: 'coroutine' object has no attribute '...'的错误时，通常意味着你尝试在一个协程对象上直接调用方法，而忘记了使用await来获取其最终结果。通过本教程提供的异步代码结构，你可以有效地解决此类问题，并顺利地在Telethon中获取和处理各种异步操作的结果，从而构建稳定可靠的Telegram客户端应用。

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