
该警告源于 Windows 系统默认 asyncio 事件循环(ProactorEventLoop)不支持 add_reader 类方法,而某些异步库(如 curl-cffi、duckduckgo-search)依赖该功能;通过提前设置 WindowsSelectorEventLoopPolicy 可彻底消除警告。
该警告源于 windows 系统默认 asyncio 事件循环(proactoreventloop)不支持 `add_reader` 类方法,而某些异步库(如 curl-cffi、duckduckgo-search)依赖该功能;通过提前设置 `windowsselectoreventlooppolicy` 可彻底消除警告。
在 Windows 上运行基于 asyncio 的 Python 程序(尤其是使用 duckduckgo_search、curl-cffi 等底层调用 libcurl 的异步库)时,常会遇到如下 RuntimeWarning:
RuntimeWarning: Proactor event loop does not implement add_reader family of methods required. Registering an additional selector thread for add_reader support. To avoid this warning use: asyncio.set_event_loop_policy(WindowsSelectorEventLoopPolicy())
⚠️ 根本原因:
自 Python 3.8 起,Windows 默认使用 ProactorEventLoop(基于 IOCP),它高效处理高并发 I/O,但不支持 add_reader/add_writer 等基于 select/poll 的底层回调注册接口。而 curl-cffi(duckduckgo_search 的底层 HTTP 引擎)需通过 add_reader 监听 socket 就绪状态,因此自动启用兼容性线程模拟,同时发出警告。
✅ 正确解决方式:
必须在任何 asyncio 操作(包括导入异步库)之前,全局设置事件循环策略为 WindowsSelectorEventLoopPolicy —— 它基于 select(),完整支持 add_reader,且兼容所有标准 asyncio API。
关键要点:
- ✅ 设置语句必须放在脚本最顶部(早于 import asyncio 以外的任何异步相关 import,如 from duckduckgo_search import DDGS);
- ❌ 仅调用 asyncio.set_event_loop_policy(...) 但位置靠后(如在 import DDGS 之后)将无效,因为 DDGS 初始化时已创建并使用了默认事件循环;
- ❌ 不应在 async def 函数内或事件循环启动后设置(此时策略已锁定)。
以下是修正后的完整示例代码:
图片提示词生成器?不止如此。 马甲系统 —— 把脑海中的画面,翻译成AI能理解的专业表达。 用得越多,它越懂你:首次需要多问几句确认方向,用久了几乎一说就懂。 用得越多,它越快:缓存机制让后续对话越来越省。 RAG进化:成功案例持续入库,越跑越聪明。 输入「新手指南」查看完整功能介绍
# ✅ 必须置于所有异步相关 import 之前!
import asyncio
asyncio.set_event_loop_policy(asyncio.WindowsSelectorEventLoopPolicy())
# ✅ 此时再导入依赖 asyncio 的库
import pandas as pd
from duckduckgo_search import DDGS
# 同步调用(DDGS().text 是同步接口,内部已封装 asyncio)
search_query = 'Python tutorials'
results = DDGS().text(
keywords=search_query,
region='wt-wt',
safesearch='off',
timelimit='7d',
max_results=50
)
print(f"Found {len(results)} results")? 补充说明:
立即学习“Python免费学习笔记(深入)”;
- DDGS().text(...) 表面是同步调用,实则内部使用 asyncio.run() 启动事件循环,因此仍受全局策略影响;
- 若你自行编写 async/await 逻辑,也需确保 asyncio.run(...) 在已设置策略的环境中执行;
- 该方案仅适用于 Windows;Linux/macOS 默认使用 SelectorEventLoop,无需额外配置;
- 升级到较新版本的 curl-cffi>=0.7.0 和 duckduckgo-search>=5.0.0 可缓解部分兼容性问题,但策略设置仍是推荐的稳定解法。
总结:只需将 asyncio.set_event_loop_policy(asyncio.WindowsSelectorEventLoopPolicy()) 放在脚本第一行(紧随 import asyncio 后),即可一劳永逸消除警告,且不影响功能与性能。

















