Pytest测试FastAPI+Prisma报asyncio事件绑定不同事件循环错误

该错误本质是异步资源生命周期与事件循环生命周期不匹配导致的绑定冲突，具体触发逻辑如下：

• prisma-client-py 内部的异步锁、连接池等原语会在首次建立连接时，绑定到当前运行的事件循环，且后续不会自动重新绑定新的事件循环。你当前配置中app为session作用域、event_loop为module作用域，跨module执行测试时，新的module级事件循环会替换旧循环，但session级app挂载的prisma实例仍持有旧循环的绑定引用，调用时就会抛出<asyncio.locks.Event object> is bound to a different event loop错误。
• 首个测试用例耗时偏高是正常现象：首次执行需要完成测试库初始化、prisma连接池建立、TestClient启动全量流程，后续用例复用已初始化的资源因此耗时明显降低。
• 首尾用例固定报错的原因：首个用例触发prisma实例首次绑定初始事件循环，最后一个用例执行完成后，手动编写的事件循环关闭逻辑会先销毁循环，再触发prisma内部资源的异步清理逻辑，此时清理逻辑持有的Event等对象仍指向已销毁的旧循环，直接触发异常。
• 额外隐患：pytest-asyncio默认提供的event_loopfixture为function作用域，手动修改为module作用域时，没有同步对齐prisma、TestClient等异步资源的作用域，同步版本的TestClient还会隐式创建/捕获事件循环，进一步加剧循环绑定错位的问题。

按照优先级选择以下方案即可解决问题：

方案1：统一所有异步相关fixture的作用域（推荐） #

将涉及异步逻辑的event_loop、prisma连接、app、client fixture全部设置为相同作用域，推荐测试场景下统一使用module作用域，确保所有异步资源的生命周期和所属事件循环的生命周期完全对齐，参考实现如下：

import asyncio
import pytest
from httpx import AsyncClient
from prisma import Prisma
# 替换为你项目中实际的app导入路径、prisma依赖获取方法
from main import app
from app.deps import get_prisma

@pytest.fixture(scope="module")
def event_loop():
    loop = asyncio.new_event_loop()
    yield loop
    loop.close()

@pytest.fixture(scope="module")
async def prisma_test_client(event_loop):
    # 每个测试模块单独初始化prisma实例，强制绑定当前模块的事件循环
    prisma = Prisma()
    await prisma.connect()
    # 此处执行测试库初始化逻辑：建表、写入基础测试数据等
    yield prisma
    await prisma.disconnect()
    # 此处执行测试库清理逻辑：删表、清空测试数据等

@pytest.fixture(scope="module")
def test_app(prisma_test_client):
    # 通过依赖覆盖替换业务代码中的prisma实例，避免复用全局实例的旧循环绑定
    app.dependency_overrides[get_prisma] = lambda: prisma_test_client
    yield test_app
    app.dependency_overrides.clear()

@pytest.fixture(scope="module")
async def client(test_app):
    # 用异步AsyncClient替代同步TestClient，避免同步客户端隐式操作事件循环导致的错位
    async with AsyncClient(app=test_app, base_url="http://testserver") as ac:
        yield ac

注意：不需要在prisma断开逻辑后额外手动调用事件循环关闭方法，pytest-asyncio会自动处理对应作用域事件循环的销毁。

方案2：全量使用session作用域异步fixture #

如果需要跨模块复用测试资源减少初始化耗时，可以将event_loop、prisma连接、app、client全部设置为session作用域，确保整个测试执行过程中只有一个事件循环，所有异步资源从初始化到清理都绑定在同一个循环上，不会出现跨循环引用问题。该方案需要注意测试用例之间的数据隔离，每个用例执行完后要主动清理产生的测试数据，避免用例间相互影响。

方案3：规避全局实例复用 #

不要在业务代码顶层初始化全局Prisma()实例，所有prisma实例都通过FastAPI依赖注入的方式传递给路由逻辑，测试时通过依赖覆盖传入测试专用的prisma实例，从根源上避免全局实例跨事件循环复用的问题。

修正后执行全量测试：

• 首尾测试用例不再抛出事件循环绑定相关的RuntimeError
• 初始化耗时仅在第一个测试模块/首个用例出现一次，后续用例执行耗时稳定
• 测试执行完成后无事件循环已关闭、资源未释放的警告信息

内容的提问来源于stack exchange，提问作者Sheyzi Silver