validationerror 的 messages 属性结构多样，可能是字典、列表或嵌套结构，如 {'field_name': ['error message']} 或 {'0': {'name': ['missing data for required field.']}}，应使用 print(exc.messages) 查看原始结构而非 str(exc)。
ValidationError 报错时，先确认错误信息里 messages 的结构
Marshmallow 的 ValidationError 不会直接抛出字符串，而是带一个 messages 属性，它可能是字典、列表或嵌套结构。很多人一看到报错就去查字段名，却忽略 messages 实际是 {'field_name': ['error message']} 这种格式，甚至在嵌套 schema 里变成多层字典。
- 用
print(exc.messages)查看原始结构，别依赖str(exc) - 如果验证的是 list of dicts，
messages可能是{'0': {'name': ['Missing data for required field.']}}，下标是字符串而非整数 -
exc.field_names和exc.fields并不总存在，尤其在老版本（
字段缺失或类型不符？检查 required 和 load_only 是否冲突
常见现象：传了数据却报 “Missing data for required field”，或者字段明明传了却没进 data。问题往往出在 load_only=True 字段被误设为 required=True，而你又没在输入数据里提供它——Marshmallow 会严格校验所有 required 字段，不管它是不是 load_only。
-
required=True表示“输入数据中必须存在”，和序列化方向无关 - 若某字段只用于反序列化且可选，设
required=False, load_only=True，并配missing=None或其他默认值 - 用
allow_none=True控制是否接受None值，否则即使missing=None，传"null"或None仍可能失败
自定义校验器抛异常后，ValidationError 消息不显示？注意 raise ValidationError 的用法
在 validate= 函数或 @validates 方法里，直接 raise ValueError 或 raise Exception 不会被 Marshmallow 捕获为验证错误，而是变成未处理异常。必须显式 raise ValidationError，且推荐传入字符串或字典，而不是任意对象。
- 错：
raise ValueError("age must be > 0")→ 触发ValueError，不是ValidationError - 对：
from marshmallow import ValidationError，然后raise ValidationError("age must be > 0") - 更准：
raise ValidationError({"age": ["must be positive"]})，这样消息能精准绑定到字段 - 别在 validator 里 return False —— Marshmallow 不识别这个返回值，也不会报错，只是静默跳过
使用 unknown=EXCLUDE 后仍报错？确认是否漏设 unknown 在正确位置
很多人以为在 Schema 类定义里写 class Meta: unknown = EXCLUDE 就万事大吉，但如果你用的是嵌套 Schema（比如字段类型是另一个 Schema），那个嵌套 Schema 自己也得显式声明 unknown，父级的设置不会自动继承。
- 主 Schema 设了
unknown=EXCLUDE，但user=fields.Nested(UserSchema)里的UserSchema没设 → 多余字段仍会触发 ValidationError -
unknown只影响反序列化（load()），不影响序列化（dump()） - 可用
unknown=RAISE临时切换，快速定位哪些字段是意外传入的
unknown，或者自定义 validator 里忘了 import ValidationError 而用了裸 raise。这两个点不排查完，光改主 Schema 很难见效。Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
