如何为python-firestore的AsyncClient设置请求超时配置

你遇到的未达超时时间就直接抛出503错误的核心原因：

• asyncio.wait_for 只能管控协程的整体最大执行时长，无法拦截底层依赖库提前抛出的错误
• Firestore AsyncClient 底层基于gRPC实现，默认配置下当目标服务完全不可达时，gRPC的连接探测逻辑会立刻抛出503 failed to connect to all addresses错误，触发时机远早于你设置的10秒超时

方案1：使用Firestore方法原生的timeout参数（推荐线上场景使用） #

Firestore的所有异步操作方法（add/get/set/update等）原生支持timeout参数，会直接作用于gRPC请求的全生命周期，不需要外层嵌套asyncio.wait_for：

from firebase_admin import firestore
db_client = firestore.AsyncClient()

async def some_function():
    await db_client.collection('states').add(
        document_data={'some':'values'},
        timeout=10  # 单位为秒，直接配置请求超时
    )

该方案可以满足绝大多数正常网络场景下的超时控制需求，适配Firestore官方的客户端重试逻辑。

方案2：搭配错误捕获+等待逻辑，实现超时时间内的持续尝试（适合本地调试/特殊网络场景） #

如果你需要在服务完全不可达的场景下，也等待满10秒再抛出超时错误，可以通过捕获连接错误+循环尝试的方式实现：

import asyncio
from google.api_core.exceptions import ServiceUnavailable
from firebase_admin import firestore

db_client = firestore.AsyncClient()

async def some_function():
    # 封装成持续尝试的子协程
    async def add_until_success():
        while True:
            try:
                return await db_client.collection('states').add({'some':'values'})
            except ServiceUnavailable:
                # 捕获连接失败错误，间隔0.5秒重试
                await asyncio.sleep(0.5)
    
    # 用wait_for管控最大等待时长
    await asyncio.wait_for(add_until_success(), timeout=10)

内容的提问来源于stack exchange，提问作者Keisuke Nagakawa 永川 圭介