如何让uWSGI主线程不处理Django请求以规避SynchronousOnlyOperation报错

问题根源 #

Django 3.1及以上版本内置了同步上下文检测逻辑：如果处理同步请求的线程中存在正在运行的事件循环，会主动抛出SynchronousOnlyOperation异常，避免异步数据库/IO操作在同步上下文中出现不可预期的行为。
你当前的代码在应用初始化阶段（uWSGI主进程加载应用的阶段）就完成了X类的实例化，实例绑定的事件循环属于主进程的初始化线程。当uWSGI将请求分配到这个初始化线程处理时，就会触发上述检测逻辑报错。

可落地的修复方案 #

方案1：重构事件循环使用逻辑，每次调用独立创建循环 #

不提前绑定固定线程的事件循环，每次调用do_stuff时新建独立的事件循环执行异步逻辑，执行完成后立即关闭，完全避免和Django的请求线程循环冲突：

import asyncio
class X:
    async def foo(self):
        # 原有异步逻辑不变
        ...

    def do_stuff(self):
        # 每次调用创建全新的事件循环
        loop = asyncio.new_event_loop()
        try:
            return loop.run_until_complete(self.foo())
        finally:
            loop.close()

修改后原有全局实例化逻辑不需要改动，兼容现有调用方式。

方案2：全局实例改为懒加载，在工作线程中完成初始化 #

不要在__init__.py加载阶段直接实例化X类，改为首次调用时再初始化，确保实例绑定的是工作线程的事件循环，而非初始化线程的循环：

1. 修改myapp的__init__.py代码：

import asyncio
class X:
    # 原有类实现不变
    def __init__(self):
        self.__loop = asyncio.get_event_loop()
    async def foo(self):
        ...
    def do_stuff(self):
        self.__loop.run_until_complete(foo())

# 改为懒加载获取实例
_x_instance = None
def get_x():
    global _x_instance
    if _x_instance is None:
        _x_instance = X()
    return _x_instance

2. 视图中修改导入调用逻辑：

from myapp import get_x

def example_view(request):
    result = get_x().do_stuff()
    return JsonResponse({"result": result})

方案3（最稳定）：异步逻辑跑在专属独立线程 #

单独开辟一个守护线程运行专属事件循环，所有异步任务都提交到这个独立线程的循环中执行，完全不和Django的请求线程共用循环，从根源避免检测冲突：

import asyncio
import threading

class X:
    def __init__(self):
        # 创建独立事件循环和专属运行线程
        self.__loop = asyncio.new_event_loop()
        self.__worker_thread = threading.Thread(
            target=self.__loop.run_forever,
            daemon=True
        )
        self.__worker_thread.start()

    async def foo(self):
        # 原有异步逻辑不变
        ...

    def do_stuff(self):
        # 提交异步任务到专属线程的循环，同步等待执行结果
        future = asyncio.run_coroutine_threadsafe(self.foo(), self.__loop)
        return future.result()

该方案兼容多进程多线程的uWSGI部署模式，每个uWSGI工作进程会独立创建自己的专属线程和循环，不存在跨进程冲突问题。

内容的提问来源于stack exchange，提问作者Shubham Dhingra