最常见错误是字段类型选错：charfield未设max_length致截断，长文本应选textfield；foreignkey必设on_delete；__str__须返回字符串；时间字段慎用auto_now。
字段类型选错导致迁移失败或数据截断
最常见的是把 CharField 当成万能字符串字段，结果存邮箱、URL 或 JSON 字符串时没设足够 max_length，后期加长又得重跑迁移；或者该用 TextField 存大段文本（比如用户评论、文章正文）却硬塞进 CharField，MySQL 会默默截断超出部分，还不报错。
实操建议：
-
CharField仅用于长度可预期的短文本（用户名、状态码、枚举值），务必显式写max_length，别依赖默认值 - 长文本、不确定长度的内容一律用
TextField，它不设长度限制，也不触发数据库层面的截断逻辑 - 邮箱、URL、JSON 数据优先用专用字段：
EmailField、URLField、JSONField（Django 3.1+），它们自带校验和序列化逻辑，比CharField更安全 - 别用
TextField存二进制数据（如图片 base64），那是BinaryField的活，否则可能在某些数据库驱动下出编码错误
外键和多对多关系漏写 on_delete 直接报错
Django 2.0+ 强制要求 ForeignKey 必须显式声明 on_delete 参数，否则 makemigrations 阶段就卡住，错误信息是：TypeError: __init__() missing 1 required positional argument: 'on_delete'。很多人复制旧代码或查文档不细，直接删掉参数就跑，结果当场失败。
实操建议：
- 删除关联对象时想级联删子记录？用
on_delete=models.CASCADE - 想保留子记录，只清空外键字段？用
on_delete=models.SET_NULL，但记得同时加null=True - 想设为某个默认值（比如“未知分类”）？用
on_delete=models.SET_DEFAULT，并确保字段有default=... -
ManyToManyField不需要on_delete，但它必须定义在“发起方”模型上，且不能加blank=False到中间表字段里——那是无效的
__str__ 方法返回非字符串引发后台崩溃
后台列表页、调试输出、日志里大量调用模型实例的 __str__，如果这里返回了数字、None 或自定义对象，页面直接 500，错误信息通常是：TypeError: __str__ returned non-string (type int)。新手常在这里用 return self.id 或 return self.title 却没检查 title 是不是 None。
实操建议：
- 永远返回
str类型：用f"{self.name}"或str(self.name)包一层 - 字段可能为空？先判空：
return self.title or "无标题" - 避免在
__str__里做数据库查询（比如self.author.name），会拖慢后台列表渲染，用select_related在视图层预加载更合适 - 如果模型字段含敏感信息（如手机号后四位），
__str__里别直接暴露，按需脱敏
时间字段没设 auto_now 和 auto_now_add 的真实影响
auto_now 和 auto_now_add 看似方便，但它们绕过 ORM 正常赋值流程：每次 save() 都强制覆盖值，连 bulk_create、update()、管理命令导入数据时都不买账。结果就是“创建时间”被误刷成更新时间，“更新时间”在批量操作后全变成同一秒。
实操建议：
- 要自动记录创建时间？用
default=timezone.now（注意不带括号），配合editable=False - 要自动更新时间？在模型的
save()方法里手动赋值：self.updated_at = timezone.now()，这样可控且兼容所有写入方式 -
auto_now只适合极简场景（比如草稿临时标记），一旦涉及数据迁移、测试 fixture 或审计需求，立刻翻车 - 所有时间字段都加上
db_index=True，尤其created_at和updated_at，否则按时间范围查列表会慢得明显
default 和 null 的组合逻辑，还有 blank 对表单的影响，那已经不是模型层的事了。
