PyMongo Python 3 兼容性指南：二进制数据处理与对象序列化-优快云博客

PyMongo Python 3 兼容性指南：二进制数据处理与对象序列化

mongo-python-driver PyMongo - the Official MongoDB Python driver 项目地址: https://gitcode.com/gh_mirrors/mo/mongo-python-driver

PyMongo对Python 3的支持情况

PyMongo作为MongoDB官方Python驱动，对Python 3提供了全面支持。目前支持的版本包括：

CPython 3.9及以上版本
PyPy3.10及以上版本

Python 3中的二进制数据处理变化

PyMongo在Python 2和Python 3中对二进制数据的处理存在一个关键差异，这是开发者需要特别注意的。

二进制数据编码差异

在Python 3中，bytes类型实例会被编码为BSON类型5（二进制数据），子类型为0。当从数据库读取时，这些数据会被解码回bytes类型。而在Python 2中，同样的数据会被解码为bson.binary.Binary对象（子类型为0）。

Python 3示例：

import pymongo
client = pymongo.MongoClient()
# 插入bytes数据
result = client.test.bintest.insert_one({'binary': b'Python 3 bytes string'})
# 查询数据
doc = client.test.bintest.find_one()
print(doc['binary'])  # 输出: b'Python 3 bytes string'

Python 2示例：

import pymongo
client = pymongo.MongoClient()
doc = client.test.bintest.find_one()
print(doc['binary'])  # 输出: Binary('Python 3 bytes string', 0)

JSON二进制数据处理

类似的行为差异也存在于JSON二进制数据的解析中。对于子类型为0的二进制数据：

Python 3会解码为bytes
Python 2会解码为bson.binary.Binary

Python 3 JSON解析示例：

from bson.json_util import loads
json_data = '{"data": {"$binary": "U3RyaW5nIGVuY29kZWQgaW4gYmFzZTY0", "$type": "00"}}'
result = loads(json_data)
print(result['data'])  # 输出: b'String encoded in base64'

Python 2 JSON解析示例：

from bson.json_util import loads
json_data = '{"data": {"$binary": "U3RyaW5nIGVuY29kZWQgaW4gYmFzZTY0", "$type": "00"}}'
result = loads(json_data)
print(result['data'])  # 输出: Binary('String encoded in base64', 0)

ObjectId的跨版本序列化问题

PyMongo中的ObjectId对象在Python 2和Python 3之间的序列化(pickle)存在一些兼容性问题，需要特别注意。

Python 2到Python 3的反序列化

从Python 2序列化的ObjectId可以在Python 3中反序列化，但需要指定编码为'latin-1'：

# Python 2序列化的数据
pickled_data = b'ccopy_reg\n_reconstructor\np0\n(cbson.objectid...'

# Python 3中反序列化
import pickle
from bson.objectid import ObjectId
oid = pickle.loads(pickled_data, encoding='latin-1')
print(oid)  # 输出类似: ObjectId('5f96f20c430ee6bd06000000')

Python 3到Python 2的反序列化

如果需要在Python 3中序列化ObjectId并在Python 2中反序列化，必须使用协议版本2或更低：

# Python 3中序列化
import pickle
from bson.objectid import ObjectId
oid = ObjectId()
pickled_data = pickle.dumps(oid, protocol=2)

# Python 2中反序列化
import pickle
oid = pickle.loads(pickled_data)
print(oid)