Django ForeignKey on_delete 参数全解析：从源码到实战配置

Ivy

发布时间：2026-10-13| 1人浏览过

原创

本文深入解析Django 2.0+中ForeignKey的on_delete参数，结合源码说明其必要性。详细阐述CASCADE、PROTECT、SET_NULL、SET_DEFAULT及自定义SET()五种删除行为，并解释to、related_name、to_field等关键参数的作用与限制，帮助开发者根据业务需求选择合适的数据关联策略。

Django外键参数必要性及源码分析

在Django 2.0及以上版本中，定义外键或一对一关系时，必须显式指定on_delete参数。通过查看框架源码可知，这是强制要求，旨在明确数据关联在源记录删除时的行为。

ForeignKey源码关键参数解析


class ForeignKey(ForeignObject):
  """
  Provide a many-to-one relation by adding a column to the local model
  to hold the remote value.

  By default ForeignKey will target the pk of the remote model but this
  behavior can be changed by using the ``to_field`` argument.
  """

  # Field flags
  many_to_many = False
  many_to_one = True
  one_to_many = False
  one_to_one = False

  rel_class = ManyToOneRel

  empty_strings_allowed = False
  default_error_messages = {
    'invalid': _('%(model)s instance with %(field)s %(value)r does not exist.')
  }
  description = _("Foreign Key (type determined by related field)")

  def __init__(self, to, on_delete, related_name=None, related_query_name=None,
         limit_choices_to=None, parent_link=False, to_field=None,
         db_constraint=True, **kwargs):

to：指定关联的目标模型或表名。
on_delete：定义当源表中的关联记录被删除时，外键字段应采取的操作策略。
related_name：用于反向查询的参数。设置后，可通过被关联表实例反向访问外键所在表的数据。若未指定，默认值为set_表名。
to_field：指定关联的字段，默认为目标表的主键。MySQL仅支持主键作为外键，即使未显式定义主键，Django也会自动创建。若采用数据库优先（DB-first）策略且未手动创建主键，数据库可能默认使用隐藏字段DB_ROW_ID作为主键。