PyMongo设置Cursor的batch_size参数后仍逐文档返回问题

你对batch_size参数的作用存在认知偏差，这个参数的实际生效逻辑和你预期的完全不一样：

• batch_size控制的是MongoDB客户端和服务端之间单次网络往返传输的文档数量上限，属于网络IO层面的调优参数，不会改变游标遍历的默认行为：你直接用for i in cursor迭代时，驱动会把每次从服务端拉回来的整批文档拆成单条，逐个返回给循环体，所以不管你把batch_size设成多少，这种写法下循环每次都只会拿到1条文档，属于正常表现，不是参数失效。
• 如果你抓包观察到实际网络请求里每次也只返回1条文档，通常是两个原因导致：要么单条匹配文档的体积过大，驱动为了不触碰MongoDB单条响应16MB的大小上限，自动调小了实际生效的批次大小；要么你用的游标是特殊类型（比如tailable游标、snapshot游标），这类游标的batchSize有单独的适配逻辑，不会完全按传入值执行。

不要直接迭代游标对象来拿批量结果，用驱动提供的批次拉取接口即可，以最常用的PyMongo驱动为例：

# 省略连接初始化逻辑
cursor = collection.find(
    {'Time': {'$gt': 58006}},
    {'V1': 1, 'V2': 1},
    batch_size=9 # 这里设置的是单次网络拉取的最大文档数，和批次拉取逻辑对应
)

# 按批次获取结果，每次循环拿到的batch是最多包含9条文档的列表
while cursor.alive:
    batch = cursor.next_batch()
    print(f"当前批次文档数：{len(batch)}")
    for doc in batch:
        # 处理单条文档逻辑
        print(doc)

注意事项 #

• 不要把batch_size设置得过大，单批次所有文档的总大小不能超过16MB，否则驱动会自动截断批次，不会按你设置的数值返回。
• 如果要验证batch_size是否真的生效，不要看for循环的单次输出，要开启驱动的命令监控日志，查看find和后续getMore命令的返回文档数，这个数值才是参数实际生效的结果。

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