为何无法直接显式调用bson.json_util.dumps？函数导入疑问

咱们先拆解你遇到的问题核心，其实本质上和Python的模块导入机制以及bson.json_util的内部实现有关，主要有两个常见原因：

1. 命名空间未正确导入导致的NameError #

如果你的代码一开始是用from bson.json_util import dumps这种方式导入单个函数，而没有导入bson模块本身，那当你后来想显式写bson.json_util.dumps时，Python会找不到bson这个命名空间，直接抛出NameError: name 'bson' is not defined。

举个典型的错误例子：

# 只导入dumps函数，没导入bson模块本身
from bson.json_util import dumps
import json

# 之前用dumps(cursor)没问题
dumps(collection.find())

# 现在想显式调用bson.json_util.dumps，会报错
bson.json_util.dumps(collection.find())  # 错误：NameError

这不是bson.json_util.dumps本身的问题，而是你没有正确导入bson模块的完整命名空间。

2. bson.json_util的猴子补丁副作用 #

另一个深层原因是：bson.json_util在导入时，会对Python标准库的json模块做猴子补丁——它会替换json模块的默认编码器，让普通的json.dumps也能处理BSON特有的类型（比如ObjectId、Datetime、Decimal128等）。

但这个补丁会带来隐性问题：当你同时使用json.dumps和bson.json_util.dumps时，两者的编码器逻辑可能互相干扰：

• bson.json_util.dumps内部其实是基于标准库json.dumps实现的，它会传入自定义的default参数和cls参数来处理BSON类型。
• 但如果标准库的json已经被猴子补丁修改了默认编码器，那么bson.json_util.dumps的内部调用可能会出现参数冲突或者递归处理的问题，导致报错。

怎么解决？ #

方案一：正确导入命名空间 #

如果你想显式调用bson.json_util.dumps，确保先导入bson.json_util模块：

import json
import bson.json_util  # 导入整个模块，让bson.json_util命名空间可用

# 现在可以正常显式调用
bson.json_util.dumps(collection.find())
# 同时也能使用标准库的json.dumps处理普通数据
json.dumps({"name": "test"})

方案二：禁用猴子补丁（更干净） #

如果你不想让bson.json_util修改标准库的json模块，可以在导入时关闭自动补丁：

import json
from bson import json_util
json_util.patch_encoder = False  # 关闭自动猴子补丁

# 显式调用bson.json_util.dumps处理MongoDB cursor
json_util.dumps(collection.find())
# 标准库json.dumps处理普通数据不受影响
json.dumps({"name": "test"})

方案三：使用别名（简洁又安全） #

其实用别名也很简洁，还能彻底避免命名冲突：

import json
from bson.json_util import dumps as bson_dumps

# 处理MongoDB cursor用bson_dumps
bson_dumps(collection.find())
# 处理普通JSON用json.dumps
json.dumps({"name": "test"})

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