Django集成Azure App Insights遇OpencensusMiddleware '_is_coroutine'错误

问题原因 #

这个错误源于Django 3.0+默认启用的ASGI模式与旧版OpenCensus Django中间件不兼容。ASGI服务器会检测中间件是否包含_is_coroutine属性来区分同步/异步中间件，而旧版OpenCensus中间件仅适配WSGI环境，未实现该属性。

可行解决方案 #

• 升级OpenCensus Django包
  这是最彻底的修复方式，新版本已适配ASGI环境：

  pip install --upgrade opencensus-django
  

• 强制使用WSGI模式（临时方案）
  如果暂时无法升级包，可以在启动Django时强制切换到WSGI模式：

  python manage.py runserver --wsgi
  

  部署时也需配置服务器使用WSGI而非ASGI（比如Gunicorn而非Uvicorn）。

• 手动添加_is_coroutine属性（应急方案）
  在settings.py中导入中间件后，手动添加该属性，让ASGI服务器将其识别为同步中间件：

  from opencensus.ext.django.middleware import OpencensusMiddleware
  
  # 标记为非协程中间件
  OpencensusMiddleware._is_coroutine = False
  
  # 后续正常配置中间件
  MIDDLEWARE = [
      # ... 其他中间件
      'opencensus.ext.django.middleware.OpencensusMiddleware',
      # ...
  ]
  

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