Python类方法中写await报错的根本原因是：只有async def定义的函数才是协程函数，才能在函数体内使用await；普通def方法中用await会触发SyntaxError，而__init__等特殊方法不能声明为async。
Python 类方法本身完全支持 await，问题出在调用方式或方法定义上——最常见的是忘了加 async 声明，或误把同步方法当协程调用。
为什么类方法里写 await 会报 SyntaxError 或 RuntimeError？
根本原因是：只有被 async def 定义的函数才是协程函数，才能在函数体内使用 await。普通 def 方法哪怕只有一行 await asyncio.sleep(1)，也会直接报 SyntaxError: 'await' outside async function。
常见错误场景：
- 在
def __init__(self)里写await——__init__必须是同步的，不能是async def - 写了
async def fetch_data(self)，但调用时没加await，比如直接写obj.fetch_data()—— 这返回的是一个协程对象，不是结果 - 在同步方法中尝试
await另一个协程，但没把当前方法也声明为async
如何正确定义和调用异步类方法？
必须同时满足两个条件：定义用 async def，调用用 await（且只能在另一个 async 函数或 asyncio.run() 中）。
立即学习“Python免费学习笔记（深入）”；
示例：
import asyncio
<p>class APIClient:
async def get_user(self, user_id: int) -> dict:
await asyncio.sleep(0.1) # 模拟网络等待
return {"id": user_id, "name": "alice"}</p><h1>✅ 正确调用方式</h1><p>async def main():
client = APIClient()
data = await client.get_user(123) # 必须 await
print(data)</p><p>asyncio.run(main()) # 入口必须用 asyncio.run() 或其他事件循环驱动
注意：get_user 是实例方法，self 不影响异步性；静态方法和类方法同理，只需加上 async 前缀（如 @staticmethod + async def）。
想在 __init__ 里做异步初始化怎么办？
不行。__init__ 必须返回 None，不能是协程。绕过方案只有两个：
-
显式异步初始化方法：定义
async def init(self)，创建实例后立刻await obj.init() -
工厂函数封装：用
async def create_client()返回已准备好的实例，避免暴露未初始化对象
例如：
class DatabasePool:
def __init__(self):
self.pool = None
<pre class="brush:php;toolbar:false;">async def init(self):
# 模拟异步连接池创建
await asyncio.sleep(0.2)
self.pool = "ready"使用：
async def main(): db = DatabasePool() await db.init() # 显式初始化 print(db.pool)
别试图用 __aenter__ 替代——那只是上下文管理协议，不解决构造阶段的问题。
装饰器、属性、__call__ 怎么处理异步？
所有可调用对象若需 await，都必须是协程函数。这意味着：
- 自定义装饰器包装异步方法时，内部要
await被装饰函数，并用async def定义装饰器逻辑 -
@property不能是异步的——属性访问必须同步。要用async def get_xxx(self)替代 -
__call__可以是async def __call__(self, ...)，但调用时仍需await obj(...)
典型陷阱：@cached_property 不支持异步，别往上面套 async 方法；要用 aiocache 或手动缓存 + async 方法。
真正卡住人的地方往往不是语法，而是混淆了“能写 await”和“能被 await”——前者看定义，后者看返回值类型。协程函数返回协程对象，而协程对象才可被 await；漏掉任一环，错误信息就可能指向奇怪的位置。
