Pymongo与Beanie兼容问题：导入Document时_QUERY_OPTIONS导入错误

1. 定位问题根源 #

_QUERY_OPTIONS是PyMongo内部的私有常量，在PyMongo 4.10及以上版本中被移除。你的Beanie 1.29.0和Mongoengine 0.29.1版本均未适配该变更，导致导入失败。

2. 版本适配方案 #

方案A：升级Beanie至兼容版本 #

Beanie 1.30.0及以上版本修复了PyMongo 4.10+的兼容性问题，执行命令：

pip install --upgrade beanie>=1.30.0

方案B：降级PyMongo至兼容版本 #

若不想升级Beanie，将PyMongo降级到4.9.x版本（Beanie 1.29.0支持的最高PyMongo版本）：

pip install pymongo==4.9.1

同时需注意：Mongoengine 0.29.1最高支持PyMongo 4.8.x，若采用此方案，需同步升级Mongoengine至0.30.0+：

pip install --upgrade mongoengine>=0.30.0

3. 彻底更新依赖 #

清理pip缓存并重新安装所有依赖，避免版本冲突残留：

pip cache purge
pip install -r requirements.txt

验证修复 #

重新执行from beanie import Document，确认错误不再出现。

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