使用MongoEngine与mongomock时的UUID存储兼容问题

生产代码使用MongoEngine的UUIDField存储UUID作为主键：

class TestEntry(Document):
    uuid_test = UUIDField(primary_key=True)

生产环境连接真实MongoDB时运行正常：

connect('mydatabase', host='localhost', port=27017)
_uid = uuid.uuid4()
entry = TestEntry(uuid_test=_uid)
entry.save()

但单元测试改用mongomock.MongoClient替换真实客户端时，出现编码错误：

ValueError: cannot encode native uuid.UUID with UuidRepresentation.UNSPECIFIED.
UUIDs can be manually converted to bson.Binary instances using bson.Binary.from_uuid()
or a different UuidRepresentation can be configured.
See the documentation for UuidRepresentation for more information.

尝试手动转换UUID为BSON Binary时，又触发MongoEngine的验证错误：

mongoengine.errors.ValidationError: ValidationError
(TestEntry:b'\xe7\xbe.h\xbe\xcfE\x95\x86%u\x15\xefA\x9a\x80')
(Could not convert to UUID: badly formed hexadecimal UUID string: ['uuid_test'])

需要实现真实MongoDB客户端与mongomock客户端的兼容使用，求最佳实践。

1. 统一UUID表示配置 #

连接数据库时显式指定uuidRepresentation参数，让真实MongoDB客户端和mongomock使用相同的UUID编码规则，避免编码/解码不一致问题。推荐使用'pythonLegacy'（与旧版MongoEngine默认行为一致）或'standard'（符合MongoDB官方标准），两端保持统一即可。

示例代码：

import uuid
from mongoengine import connect, Document, UUIDField
import mongomock

# 生产环境连接（真实MongoDB）
connect(
    'mydatabase',
    host='localhost',
    port=27017,
    uuidRepresentation='pythonLegacy'
)

# 测试环境连接（mongomock）
connect(
    'mydatabase',
    mongo_client_class=mongomock.MongoClient,
    uuidRepresentation='pythonLegacy'
)

# 统一的业务代码（无需修改）
class TestEntry(Document):
    uuid_test = UUIDField(primary_key=True)

_uid = uuid.uuid4()
entry = TestEntry(uuid_test=_uid)
entry.save()

2. 禁止手动转换UUID #

MongoEngine的UUIDField会自动处理uuid.UUID对象与BSON格式的转换，手动转换为bson.Binary会导致字段验证失败（因为UUIDField期望接收原生uuid.UUID实例）。保持直接传入uuid.UUID对象即可，只要连接时配置好uuidRepresentation，底层驱动会自动完成正确的编码。

3. 确保依赖版本兼容 #

升级mongomock和pymongo到最新稳定版，旧版本的mongomock对uuidRepresentation的支持不完善，可能导致兼容性问题。

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