MongoEngine字段类型严格，StringField不能存数字、IntField不能存字符串，DateTimeField只接受datetime对象；ReferenceField需显式fetch()或select_related()获取关联数据；save()失败需捕获ValidationError并打印str(e)定位字段错误；filter语法受限，复杂查询用__raw__。
定义Document类时字段类型写错会直接报错
MongoEngine对字段类型非常严格，StringField不能存数字，IntField不能存字符串，哪怕只是JSON里传了个"123"也会在保存时抛出ValidationError。常见错误是把API传来的JSON数据不加转换就塞进IntField，结果卡在.save()那一步。
- 从HTTP请求或JSON解析来的值，务必先用
int()、float()等显式转换，再赋给对应字段 -
DateTimeField只接受datetime对象，不能用字符串（如"2024-01-01"）或时间戳直接赋值 - 字段默认值如果设为
None，MongoEngine不会跳过校验——它仍会检查类型，建议用default=None配合required=False - 嵌套文档用
EmbeddedDocumentField，别误用DictField；后者不支持字段级验证和查询语法
用ReferenceField关联文档却查不到数据
ReferenceField本质是存一个ObjectId引用，不是自动“拉取”关联文档。调用user.profile时返回的是Profile实例，但它的字段只有_id，其他字段为空——这是懒加载行为，不是bug。
- 要真正拿到关联文档内容，必须显式调用
.fetch()（MongoEngine 0.27+）或使用select_related()（旧版） -
select_related()只支持一级关联，不能链式调用.select_related().select_related() - 如果关联文档已被删除，
fetch()会返回None，不是抛异常，得自己判空 - 批量查多个带引用的文档时，
select_related()比循环每个对象单独fetch()更高效，但内存占用略高
save()失败却不报具体字段错误
默认情况下.save()失败只会抛ValidationError，但错误信息里不指明是哪个字段、哪条规则没过，调试起来像盲人摸象。
- 捕获异常后，打印
str(e)能看到完整校验路径，比如"name: Field is required"或"age: Value must be greater than 0" - 字段级自定义错误消息要用
error_messages参数：IntField(min_value=0, error_messages={'min_value': '年龄不能为负数'}) - 如果用了
strict=False，字段名拼错也不会报错，而是静默丢弃——开发阶段务必关掉 - 批量插入用
insert()时，单个文档校验失败会导致整个批次回滚，不如逐条save()并捕获处理
查询时filter写法不符合MongoDB原生逻辑
MongoEngine的filter()看着像Django ORM，但底层还是转成MongoDB查询语句，很多写法会意外失效。比如name__icontains='abc'能用，但name__regex='/abc/i'必须写成name__icontains='abc'或改用__raw__。
立即学习“Python免费学习笔记（深入）”；
- 模糊匹配优先用
__icontains或__istartswith，它们会被转成$regex且自动加i标志，比手写正则安全 - 日期范围查询用
created_at__gte=start_time，别用created_at__range=(start, end)（不支持） - 数组字段包含某值：用
tags__in=['python']，不是tags__contains='python'（后者查的是子文档） - 复杂查询绕不开时，用
__raw__直接写字典：__raw__={'tags.0': {'$exists': True}}，但失去字段类型校验
fetch()、依赖不存在的查询语法，这三类问题占了八成以上调试时间。 
