导入模块冲突导致S3上传失败，求boto3与grequests共存解决方案

冲突根源 #

该异常的根源是grequests底层依赖gevent，导入时会默认执行猴子补丁（Monkey Patch）修改Python标准库的线程、套接字等核心模块实现，而boto3依赖的botocoreHTTP客户端逻辑和补丁后的线程实现不兼容，因此触发线程切换报错。

可行解决方案 #

• 方案1：调整导入与初始化顺序（成本最低，适配90%以上场景）
  只要在导入grequests之前先完成boto3客户端的初始化，就能避开补丁对boto3逻辑的影响，示例代码如下：

import sys, os, time
import boto3, ntpath
# 先完成S3客户端初始化，此时还未执行gevent补丁
s3_client = boto3.client('s3')
# 初始化完成后再导入grequests
import grequests

• 方案2：显式控制gevent补丁范围
  如果业务逻辑要求必须先导入grequests，可以提前手动控制gevent的补丁规则，排除对线程模块的修改，避免影响boto3的线程逻辑：

from gevent import monkey
# 打补丁时排除thread模块，保留其他IO补丁能力
monkey.patch_all(thread=False)
import grequests
import boto3, ntpath

• 方案3：升级依赖版本
  部分旧版本的gevent、grequests和boto3存在已知兼容性问题，优先尝试升级所有相关依赖到最新版：

pip install --upgrade boto3 botocore grequests gevent

• 方案4：进程级隔离
  如果以上方案都不满足业务需求，可以将grequests的异步请求逻辑和boto3的S3上传逻辑拆分到不同进程运行，进程间通过队列传递数据，完全避开线程层面的模块冲突。

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