典型错误是抛出 bson.errors.InvalidId 异常，提示“xxx is not a valid ObjectId, it must be a 24-character hex string”，因长度非24、含非十六进制字符、或为 None/空字符串所致。
ObjectId 解析失败的典型错误信息是什么
运行时抛出 InvalidId 异常，比如：bson.errors.InvalidId: 'abc' is not a valid ObjectId, it must be a 24-character hex string。这说明你传给 ObjectId 构造函数的值不符合要求——长度不是 24 位、含非十六进制字符、或为 None / 空字符串。
为什么直接用字符串构造 ObjectId 容易出错
常见误区是把数据库里查出来的字段名（如 "_id"）或用户输入的任意字符串原样塞进 ObjectId()，没做校验。而 ObjectId 构造器不自动容错，也不接受带引号的 JSON 字符串、带空格的字符串、或 MongoDB shell 里显示的 ObjectId("...") 这种带包装的格式。
- 必须是纯 24 字符十六进制字符串，例如
"507f1f77bcf86cd799439011" - 大小写不敏感，但长度严格为 24 ——
"507f1f77bcf86cd79943901"（23 位）或"507f1f77bcf86cd7994390112"（25 位）都会报错 -
ObjectId(None)或ObjectId("")同样触发InvalidId - 从 Flask/Django 请求中取参数时，注意
request.args.get("id")可能返回None，需先判断
安全构造 ObjectId 的推荐写法
不要裸调 ObjectId(raw_id)，始终包裹校验逻辑。最简健壮写法：
from bson.objectid import ObjectId
<p>def safe_objectid(raw_id):
if not isinstance(raw_id, str) or len(raw_id) != 24 or not all(c in "0123456789abcdefABCDEF" for c in raw_id):
return None
try:
return ObjectId(raw_id)
except Exception:
return None</p><h1>使用示例</h1><p>oid = safe_objectid(request.args.get("id"))
if oid is None:
abort(400, "Invalid ObjectId")
collection.find_one({"_id": oid})
更省事的做法是用 bson.ObjectId.is_valid()（Python 3.9+ 的 PyMongo 4.0+ 支持）：
立即学习“Python免费学习笔记（深入）”；
if ObjectId.is_valid(raw_id):
oid = ObjectId(raw_id)
else:
# 处理无效情况
从 JSON 或其他格式反序列化时的坑
前端传来的 JSON 中，_id 通常以字符串形式存在（如 {"_id": "507f1f77bcf86cd799439011"}），不能直接当 dict 插入 MongoDB —— insert_one() 会把字符串当普通字段存，不会转成 ObjectId 类型。必须显式转换：
- 插入前：用
safe_objectid()转换data["_id"]，再赋值回字典 - 查询时：
find({"_id": {"$in": [ObjectId(x) for x in id_list if ObjectId.is_valid(x)]}) - 别用
json.loads()直接解析含ObjectId的 BSON dump 结果 —— 它不含类型信息，得靠应用层约定字段名并手动恢复
PyMongo 不会自动把文档里叫 _id 的字符串字段升级为 ObjectId；这个转换永远是你代码的责任。
