在Django中创建AD查询搜索表单时遭遇CoInitialize未调用com_error错误

嘿，这个问题我之前碰到过好几次，根源其实很明确——你用的pyad依赖Windows的COM API，但Django的多线程请求环境里，每个新线程都没初始化COM环境就直接调用pyad了，所以才会抛出(-2147221008, 'CoInitialize has not been called.', None, None)这个错误。

为什么会出现这个问题？ #

Windows的COM对象要求每个线程在第一次使用前必须调用CoInitialize来初始化线程的COM环境。Django默认用多线程处理请求，每次新请求可能分配到一个未初始化COM的线程，而pyad本身并没有自动帮你做这一步，直接调用就会报错。

具体解决步骤 #

1. 首先确保你已经安装了pywin32（pyad依赖它），如果没装的话先执行：

   pip install pywin32
   

2. 修改你的views.py代码，在调用pyad的逻辑前后手动初始化和释放COM环境：

   from pyad import pyad, aduser, adquery
   from django.contrib.auth.decorators import login_required
   import win32com.client  # 新增这个导入
   
   @login_required
   def users(request):
       if request.method == 'POST':
           form = UserSearchForm(request.POST)
           if form.is_valid():
               # 初始化当前线程的COM环境
               win32com.client.pythoncom.CoInitialize()
               try:
                   # 这里调用pyad的逻辑
                   user = pyad.from_cn(form.cleaned_data['cn'])
               finally:
                   # 最后释放COM环境，避免资源泄漏
                   win32com.client.pythoncom.CoUninitialize()
               return render(request, 'console/users/details.html', {'user': user})
       else:
           # 这里你之前的代码存在笔误，修正为正确的表单实例化
           form = UserSearchForm()
       # 补充GET请求的页面返回逻辑
       return render(request, 'console/users/search.html', {'form': form})
   

额外注意事项 #

• 不要在全局范围（比如文件开头）调用CoInitialize，因为Django的线程是复用的，全局初始化会导致线程间的COM环境冲突，必须在每个请求的处理逻辑内部单独初始化。
• 如果你后续用到pyad的其他功能（比如adquery查询），也要在调用前做同样的COM初始化操作。

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