Django类视图出现SynchronousOnlyOperation错误，异步视图无法正常使用

问题根源 #

你碰到的错误核心原因有两个：

1. 视图继承的是普通View而非Django提供的AsyncView，同步的dispatch方法与异步get方法的执行上下文冲突
2. login_required这类同步装饰器直接作用在异步视图的dispatch上，没有做异步兼容处理

修复方案 #

方案一：改用AsyncView并重写dispatch（推荐） #

将视图继承改为AsyncView，同时把同步装饰器用sync_to_async包装后在异步dispatch中调用：

from django.views.generic import AsyncView
from django.utils.decorators import method_decorator
from django.contrib.auth.decorators import login_required
from django.views.decorators.cache import never_cache
from django.conf import settings
from django.shortcuts import render
from asgiref.sync import sync_to_async

class ChatView(AsyncView):

    async def dispatch(self, request, *args, **kwargs):
        # 用sync_to_async包装同步登录验证逻辑
        login_check = sync_to_async(
            login_required(login_url=settings.LOGIN_URL)(lambda req: req),
            thread_sensitive=True
        )
        await login_check(request)
        
        # 执行父类dispatch逻辑并应用never_cache
        response = await super().dispatch(request, *args, **kwargs)
        never_cache(lambda r: r)(response)
        return response

    async def get(self, request, *args, **kwargs):
        # 同步render函数用sync_to_async包装
        return await sync_to_async(render, thread_sensitive=True)(
            request, 'chatbot/chat.html'
        )

方案二：保留View类，同步调用异步逻辑（不推荐，丢失异步优势） #

如果不想修改视图继承类，可以把异步逻辑包装成同步调用：

from django.views.generic import View
from django.utils.decorators import method_decorator
from django.contrib.auth.decorators import login_required
from django.views.decorators.cache import never_cache
from django.conf import settings
from django.shortcuts import render
from asgiref.sync import async_to_sync, sync_to_async

@method_decorator(login_required(login_url=settings.LOGIN_URL), name='dispatch')
@method_decorator(never_cache, name='dispatch')
class ChatView(View):

    def get(self, request, *args, **kwargs):
        async def async_get():
            return await sync_to_async(render)(request, 'chatbot/chat.html')
        return async_to_sync(async_get)()

重要注意事项 #

• 所有在异步上下文里调用的同步函数（如render、登录验证）必须用sync_to_async包装，建议开启thread_sensitive=True以保证Django请求上下文的正确传递
• 异步视图必须继承AsyncView，或确保视图入口（dispatch方法）是异步兼容的
• 同步装饰器不能直接作用在异步方法上，必须通过sync_to_async转换后在异步环境中调用

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