系统检查框架

    关于如何添加自己的检查并与 Django 的系统检查集成的细节,请看 系统检查主题指南

    class CheckMessage(level, msg, hint=None, obj=None, id=None)

    系统检查提出的警告和错误必须是 CheckMessage 的实例。一个实例封装了一个单一的可报告的错误或警告。它还提供适用于该信息的上下文和提示,以及用于过滤目的的唯一标识符。

    构造方法的参数:

    level

    消息的严重性。使用预定义的数值之一。DEBUGINFOWARNINGERRORCRITICAL。如果级别大于或等于 ERROR,那么 Django 将阻止管理命令的执行。等级小于 ERROR```的消息(即警告)会被报告到控制台,但可以被静默。

    msg

    描述问题的简短(少于 80 个字符)字符串。该字符串 不应 包含换行符。

    hint

    一个单行字符串,提供解决问题的提示。如果不能提供任何提示,或者提示是错误信息中不言自明的,可以省略提示,或者使用 None 值。

    obj

    可选的。为信息提供上下文的对象(例如,发现问题的模型)。该对象应该是一个模型、字段、管理器或定义了 str__() 方法的任何其他对象。该方法在报告所有消息时使用,其结果在消息之前。

    id

    可选字符串。问题的唯一标识符。标识符应遵循 applabel.X001 的模式,其中 X 是字母 CEWID 中的一个,表示消息的严重性(C 表示严重,E 表示错误等)。这个数字可由应用程序分配,但在该应用程序内应是唯一的。

    有一些子类可以使创建具有通用级别的消息更容易。当使用它们时,你可以省略 level 参数,因为它已被类名所隐含。

    class Debug(msg, hint=None, obj=None, id=None)

    class Warning(msg, hint=None obj=None, id=None)

    class Error(msg, hint=None, obj=None, id=None)

    class Critical(msg, hint=None, obj=None, id=None)

    Django 的系统检查按以下标签组织:

    • admin:检查所有管理站点的声明。
    • async_support: 检查异步相关配置。
    • caches:检查缓存相关的配置。
    • compatibility:标记版本升级可能导致的问题。
    • database:检查与数据库有关的配置问题。默认情况下不运行数据库检查,因为数据库检查的工作比普通检查的静态代码分析更多。只有通过 migrate 命令或在调用 命令时使用 --database 选项指定配置的数据库别名时,才会运行数据库检查。
    • files: Checks files related configuration.
    • models:检查模型、字段和管理器定义。
    • security:检查安全相关配置。
    • signals:检查信号声明和处理器注册信息。
    • sites : 检查 django.contrib.sites 配置。
    • staticfiles:检查 配置。
    • templates:检查模板相关配置。
    • translation:检查翻译相关配置。
    • urls:检查 URL 配置。

    一些可能通过多个标签同时注册的检查项。

    Changed in Django 3.2:

    增加了 sites 标签。

    Changed in Django 4.0:

    The files tag was added.

    异步支持

    以下检查验证了你对 的配置:

    向后兼容

    兼容性检查警告那些升级 Django 后可能出现的问题。

    • 2_0.W001:你的 URL 模式 <pattern> 有一个 route 包含 (?P<、以 ^ 开始或以 $ 结束。这可能是在从 url() 迁移到 时的一个疏忽。
    • 4_0.E001: As of Django 4.0, the values in the CSRF_TRUSTED_ORIGINS setting must start with a scheme (usually http:// or https://) but found <hostname>.

    缓存

    以下检查验证你的 CACHES 配置是否正确设置:

    • caches.E001:你必须在你的 配置中定义一个 'default' 缓存。
    • caches.W002 :你的 <cache> 配置可能会暴露你的缓存或导致你的数据损坏,因为它的 LOCATION 匹配/是在/包含 / STATIC_ROOT / 。
    • caches.W003 : 你的 <cache> 缓存 LOCATION 是相对路径。请使用绝对路径。

    数据库

    MySQL 和 MariaDB

    如果你使用的是 MySQL 或 MariaDB,将执行以下检查:

    • mysql.E001:MySQL/MariaDB 不允许有唯一约束的 CharField 有一个 max_length > 255。这项检查在 Django 3.1 中 被改为 mysql.W003,因为真正的最大尺寸取决于许多因素。
    • mysql.W002:MySQL/MariaDB 数据库连接 <alias> 未设置为严格模式。另见 。
    • mysql.W003:MySQL/MariaDB 不允许有唯一约束的 CharFieldmax_length > 255。

    Managing files

    New in Django 4.0.

    The following checks verify your setup for :

    • fields.E001:字段名不能以下划线结尾。
    • fields.E002:字段名不能有 "__"
    • fields.E003pk 是保留关键字,不能作为字段名使用。
    • fields.E004choices 必须是可迭代对象(例如,列表或元组)。
    • fields.E005: choices must be an iterable containing (actual value, human readable name) tuples.
    • fields.E006db_index 必须是 NoneTrueFalse
    • fields.E007:主键不能有 null = True
    • fields.E008:所有 validators 必须都是可调用的。
    • fields.E009max_length 太小,无法容纳 choices 中的最长值(<count> 字符)。
    • fields.E010<field> 默认值应该是一个可调用对象,而不是一个实例,这样就不会在所有字段实例之间共享。
    • fields.E100AutoField 必须设置 primary_key=True。
    • fields.E110BooleanField 不接受空值。这项检查出现在 Django 2.1 中增加对空值的支持之前
    • fields.E120CharField 必须定义一个 max_length 属性。
    • fields.E121max_length 必须是个正整数。
    • fields.W122max_length 在使用 <integer field type> 时会被忽略。
    • fields.E130DecimalField 必须定义一个 decimal_places 属性。
    • fields.E131decimal_places 必须是个非负整数。
    • fields.E132DecimalField 必须定义一个 max_digits 属性。
    • fields.E133: max_digits must be a positive integer.
    • fields.E134max_digits 必须大于或等于 decimal_places
    • fields.E140FilePathFieldallow_filesallow_folders 必须有一个被设为 True。
    • fields.E150: GenericIPAddressFields cannot have blank=True if null=False, as blank values are stored as nulls.
    • fields.E160auto_nowauto_now_adddefault 等选项是相互排斥的。这些选项只能有一个。
    • fields.W161:提供了固定的默认值。
    • fields.W162<database> 并不支持在 <field data type> 列上创建数据库索引。
    • fields.E170BinaryFielddefault 不能是字符串。使用字节内容代替。
    • fields.E180<database> 不支持 JSONField
    • fields.E190<database> 不支持对 <field_type> 进行字符序设置。
    • fields.E900IPAddressField 已被删除,但历史迁移中的支持除外。
    • fields.W900IPAddressField 已被废弃。在 Django 1.9 中,将取消对它的支持(除了历史迁移)。这个检查出现在 Django 1.7 和 1.8 中
    • fields.W901CommaSeparatedIntegerField 已被废弃。在 Django 2.0 中,对它的支持将被删除(除了在历史迁移中)。这个检查出现在 Django 1.10 和 1.11 中
    • fields.E901CommaSeparatedIntegerField 已被删除,但历史迁移中的支持除外。
    • fields.W902FloatRangeField 已被废弃,将在 Django 3.1 中删除。这项检查出现在 Django 2.2 和 3.0 中
    • fields.W903: NullBooleanField is deprecated. Support for it (except in historical migrations) will be removed in Django 4.0. This check appeared in Django 3.1 and 3.2.
    • fields.E903: NullBooleanField is removed except for support in historical migrations.
    • fields.W904: django.contrib.postgres.fields.JSONField is deprecated. Support for it (except in historical migrations) will be removed in Django 4.0. This check appeared in Django 3.1 and 3.2.
    • fields.E904: django.contrib.postgres.fields.JSONField is removed except for support in historical migrations.

    文件字段

    • fields.E200unique 不是 FileField 的有效参数。这项检查在 Django 1.11 中已被删除
    • fields.E201primary_key 对于 FileField 来说不是个有效的参数。
    • fields.E202FileFieldupload_to 参数必须是个相对路径,而不是一个相对路径。
    • fields.E210: 不能使用 ImageField,因为未安装 Pillow。

    关联字段

    • fields.E300:字段定义了与模型 <model>``的关系,该模型要么没有安装,要么是抽象的。
    • fields.E301 : 字段定义了一个与 <app_label>.<model> 模型的关系,该模型已被替换。
    • fields.E302: Reverse accessor for <app_label>.<model>.<field name> clashes with field name <app_label>.<model>.<field name>.
    • fields.E303: Reverse query name for <app_label>.<model>.<field name> clashes with field name <app_label>.<model>.<field name>.
    • fields.E304: Reverse accessor for <app_label>.<model>.<field name> clashes with reverse accessor for <app_label>.<model>.<field name>.
    • fields.E305: Reverse query name for <app_label>.<model>.<field name> clashes with reverse query name for <app_label>.<model>.<field name>.
    • fields.E306: The name <name> is invalid related_name for field <model>.<field name>.
    • fields.E307:字段 <app label>.<model>.<field name> 被声明为对 <app label>.<model> 的惰性引用,但应用程序 <app label> 没有安装或没有提供模型 <model>
    • fields.E308:反向查询名称 <related query name>,不得以下划线结束。
    • fields.E309:逆向查询名称 <related query name>,不得包含 '__'
    • fields.E310:模型 <model> 上的 <field1><field2> 等字段的子集没有唯一性。
    • fields.E311<model>.<field name> 必须是唯一的,因为它是由 ForeignKey 引用的。
    • fields.E312to_field <field name> 在相关模型 <app label>.<model> 上不存在。
    • fields.E320:字段规定 ``on_delete=SET_NULL`,但不能为空。
    • fields.E330ManyToManyField 不能是唯一的。
    • fields.E331:字段通过模型 <model> 具体说明多对多关系,该模型尚未安装。
    • fields.E332:有中间表的多对多字段不得对称。这项检查是在 Django 3.0 之前出现的
    • fields.E333:该模型被 <model> 用作中间模型,但它有两个以上的外键到 <model>,这是不明确的。你必须通过 through_fields 关键字参数指定 Django 应该使用哪两个外键。
    • fields.E334:该模型被 <model> 用作中间模型,但它有一个以上来自 <model> 的外键,这是不明确的。你必须通过 through_fields 关键字参数指定 Django 应该使用哪个外键。
    • fields.E335:该模型被 <model> 用作中间模型,但它有一个以上的 <model> 外键,这是不明确的。你必须通过 through_fields 关键字参数指定 Django 应该使用哪个外键。
    • fields.E336:该模型被 <model> 用作中介模型,但它没有 <model><model> 的外键。
    • fields.E337:字段规定了 through_fields,但没有提供应通过 <model> 用于关系的两个链接字段的名称。
    • fields.E338:中间模型 <through model>,没有字段 <field name>
    • fields.E339<model>.<field name> 不是 <model> 的外键。
    • fields.E340:该字段的中间表 <table name> 与表名 <model>/<model>.<field name> 相冲突。
    • fields.W340null 对 没有影响。
    • fields.W341ManyToManyField 不支持 validators
    • fields.W342:对 ForeignKey 设置 unique=True 与使用 OneToOneField 效果相同。
    • fields.W343: limit_choices_to has no effect on ManyToManyField with a through model. This check appeared before Django 4.0.
    • fields.W344*:该字段的中间表 <table name> 与表名 <model>/``<model>.<field name>``相冲突。
    • fields.W345: related_name has no effect on ManyToManyField with a symmetrical relationship, e.g. to “self”.

    模型

    • models.E001<swappable> 不是表单 app_label.app_name
    • models.E002<SETTING> 引用了 <model>,但该网站尚未安装,或者是抽象的。
    • models.E003:该模型通过中间模型 <app_label>.<model> 有两个相同的多对多关系。
    • models.E004id 只有在字段也设置了 primary_key=True 的情况下才能用作字段名。
    • models.E005:父模型 <model> 中的字段 <field name> 与父模型 <model> 中的字段 <field name> 发生冲突。
    • models.E006: The field <field name> clashes with the field <field name> from model <model>.
    • models.E007: 列名 <column name> 被其它字段使用的字段 <field name>
    • models.E008index_together 必须是个列表或元组。
    • models.E009: 所有 index_together 元素都必须是列表或元组。
    • models.E010unique_together 必须是个列表或元组。
    • models.E011: 所有 unique_together 元素都必须是列表或元组。
    • models.E012constraints/indexes/index_together/unique_together 引用了不存在的字段 <field name>
    • models.E013constraints/indexes/index_together/unique_together 指向一个 ManyToManyField <field name>,但 ManyToManyField 不支持该选项。
    • models.E014ordering 必须是个元组或列表(即便你只想按照一个字段进行排序)。
    • models.E015ordering 指向是不存在的字段、相关字段或查找 <field name>
    • models.E016constraints/indexes/index_together/unique_together 指的是字段 <field_name>,该字段不在模型 <model> 的本地。
    • models.E017:代理模型 <model>,包含模型字段。
    • models.E018:自动生成的列名对字段 <field> 来说太长。数据库 <alias> 的最大长度为 <maximum length>
    • models.E019:自动生成的列名对 M2M 字段 <M2M field> 来说太长。数据库 <alias> 的最大长度为 <maximum length>
    • models.E020<model>.check() 类方法目前被覆盖。
    • models.E021orderingorder_with_respect_to 不能一起使用。
    • models.E022<function> 包含对 <app label>.<model> 的惰性引用,但应用 <app label> 没有安装或没有提供模型 <model>
    • models.E023:模型名称 <model> 不能以下划线开头或结尾,因为它与查找语法相冲突。
    • models.E024:模型名称 <model> 不能包含双下划线,因为它与查找语法相冲突。
    • models.E025<property name> 属性与相关字段存取器发生冲突。
    • models.E026:该模型不能有一个以上的 primary_key=True 字段。
    • models.W027<database> 不支持检查约束。
    • models.E028db_table <db_table> 被多个模型使用:<model list>
    • models.E029:索引名 <index> 对模型 <model> 不是唯一的。
    • models.E030 :索引名 <index> 在模型 <model list> 中不是唯一的。
    • models.E031:约束名称 <constraint> 对模型 <model> 不是唯一的。
    • models.E032 : 约束名称 <constraint> 在模型 <model list> 中不是唯一的。
    • models.E033:索引名称 <index> 不能以下划线或数字开头。
    • models.E034:索引名称 <index> 不能长于 <max_length> 字符。
    • models.W035db_table <db_table> 被多个模型使用:<model list>
    • models.W036<database> 不支持带有条件的唯一约束。
    • models.W037<database> 不支持有条件的索引。
    • models.W038<database> 不支持可推迟的唯一约束。
    • models.W039<database> 不支持非键列的唯一约束。
    • models.W040<database> 不支持带有非键列的索引。
    • models.E041constraints 指向 join 字段 <field name>
    • models.W042 : 在没有定义主键类型时使用的自动创建的主键,默认为 django.db.models.AutoField
    • models.W043<database> 不支持对表达式的索引。
    • models.W044: <database> does not support unique constraints on expressions.

    安全

    安全检查并不能使你的网站安全。它们不会审计代码,进行入侵检测,或做任何特别复杂的事情。相反,它们有助于执行一个自动化的、唾手可得的检查清单,可以帮助你提高网站的安全性。

    如果使用 选项,则会运行以下检查:

    • security.W001: You do not have django.middleware.security.SecurityMiddleware in your so the SECURE_HSTS_SECONDS, , SECURE_REFERRER_POLICY, , and SECURE_SSL_REDIRECT settings will have no effect.
    • security.W002:你的 中没有 django.middleware.clickjacking.XFrameOptionsMiddleware,因此你的页面不会使用 'x-frame-options' 头。除非有很好的理由让你的网站以框架形式提供服务,否则你应该考虑启用这个头以帮助防止点击劫持攻击。
    • security.W003:你似乎没有通过中间件使用 Django 内置的跨站请求伪造保护功能( 不在你的 MIDDLEWARE 中)。启用中间件是最安全的方法,以确保你不会留下任何漏洞。
    • security.W004:你没有为 配置设置一个值。如果你的整个网站只通过 SSL 提供服务,你可能需要考虑设置一个值并启用 HTTP 严格传输安全。一定要先阅读文档,不小心启用 HSTS 会导致严重的、不可逆转的问题
    • security.W005:你没有将 设置为 True。如果没有这个设置,你的网站就有可能受到通过不安全连接到子域的攻击。只有当你确定你的域名的所有子域都应该只通过 SSL 来提供服务时,才将此设置为 True
    • security.W006:你的 SECURE_CONTENT_TYPE_NOSNIFF 配置没有设置为 True,因此你的网页不会以 'X-Content-Type-Options: nosniff' 头提供服务。你应该考虑启用这个头,以防止浏览器错误地识别内容类型。
    • security.W007: Your SECURE_BROWSER_XSS_FILTER setting is not set to True, so your pages will not be served with an 'X-XSS-Protection: 1; mode=block' header. You should consider enabling this header to activate the browser’s XSS filtering and help prevent XSS attacks. This check is removed in Django 3.0 as the X-XSS-Protection header is no longer honored by modern browsers.
    • security.W008:你的 配置没有设置为 True。除非你的网站需要通过 SSL 和非 SSL 连接,否则你可能需要将此设置设置为 True,或者配置一个负载平衡器或反向代理服务器,将所有连接重定向到 HTTPS。
    • security.W009 : 你的 SECRET_KEY 少于 50 个字符,少于 5 个唯一字符,或者前缀为 'django-insecure-',表明它是由 Django 自动生成的。请生成一个长而随机的 SECRET_KEY,否则 Django 的许多安全关键功能将容易受到攻击。
    • security.W010:你的 中有 django.contrib.session,但你没有将 SESSION_COOKIE_SECURE 设置为 True。使用仅安全的会话 cookie 可以使网络流量嗅探器更难劫持用户会话。
    • security.W011:您的 中有 django.contrib.session.middleware.SessionMiddleware,但你没有将 SESSION_COOKIE_SECURE 设置为 True。使用仅安全的会话 cookie 可以使网络流量嗅探器更难劫持用户会话
    • security.W012: 未设置为 True。使用仅安全的会话 cookie 使网络流量嗅探者更难劫持用户会话。
    • security.W013:你的 INSTALLED_APPS 中有 django.contrib.session,但你没有将 设置为 True。使用 HttpOnly 的会话 cookie 可以使跨站脚本攻击更难劫持用户会话。
    • security.W014:你的 MIDDLEWARE 中有 ,但你没有将 SESSION_COOKIE_HTTPONLY 设置为 True。使用 HttpOnly 的会话 cookie 可以使跨站脚本攻击更难劫持用户会话。
    • security.W015: 未设置为 True。使用 HttpOnly 的会话 cookie 使跨站脚本攻击更难劫持用户会话。
    • security.W016CSRF_COOKIE_SECURE 未设置为 True。使用仅安全的 CSRF cookie 会使网络流量嗅探者更难窃取 CSRF 令牌。
    • security.W017: 未设置为 True。使用 HttpOnly CSRF cookie 会使跨站脚本攻击更难窃取 CSRF 令牌。这个检查在 Django 1.11 中被删除了,因为 \ :setting:`CSRF_COOKIE_HTTPONLY` * 配置没有实际的好处*。
    • security.W018:在部署时不应将 DEBUG 设置为 True
    • security.W019:在你的 中有 django.middleware.clickjacking.XFrameOptionsMiddleware,但 没有设置为 'DENY'。除非有很好的理由让你的网站在一个框架中为其他部分服务,否则你应该把它改为 'DENY'
    • security.W020ALLOWED_HOSTS 在部署时不得为空。
    • security.W021:你没有将 设置为 True。否则,你的网站将无法提交到浏览器预加载列表。
    • security.W022:你没有设置 SECURE_REFERRER_POLICY 配置。如果没有这个配置,你的网站将不会发送 Referrer-Policy 头。你应该考虑启用这个头以保护用户隐私。
    • security.E023:你的 配置为无效值。
    • security.E024: You have set the SECURE_CROSS_ORIGIN_OPENER_POLICY setting to an invalid value.

    以下检查验证你的安全相关配置是否正确设置:

    • security.E100: DEFAULT_HASHING_ALGORITHM must be 'sha1' or 'sha256'. This check appeared in Django 3.1 and 3.2.
    • security.E101 : CSRF 失败视图 'path.to.view' 没有使用正确的参数个数。
    • security.E102 : 无法导入 CSRF 失败视图 'path.to.view'

    信号

    • signals.E001<handler><signal> 信号连接,并惰性引用发送方 <app label>.<model>,但应用 <app label> 没有安装或没有提供模型 <model>

    模板

    以下检查验证你的 配置是否正确设置:

    • templates.E001:你在你的 TEMPLATES 中有 'APP_DIRS': True ,但在 OPTIONS 中也指定了 'loaders'。要么删除 APP_DIRS,要么删除 'loaders' 选项。
    • templates.E002string_if_invalid 在 的 OPTIONS 必须是一个字符串,但得到:{value}{type})。

    翻译

    以下是对你的翻译配置进行的检查:

    • translation.E001::你为 LANGUAGE_CODE 设置提供了一个无效值 setting: <value>
    • translation.E002:你在 配置中提供了无效的语言代码 setting: <value>
    • translation.E003:你在 LANGUAGES_BIDI 设置中提供了一个无效的语言代码 setting: <value>
    • translation.E004:你为 配置提供了一个不在 LANGUAGES 配置中的值。

    以下检查项针对你的 URL 配置执行:

    • urls.W001:你的 URL 模式 <pattern> 使用 ,并以 $ 结尾的 route。把 route 中的美元符号去掉,以避免包含 URL 的问题。
    • urls.W002:你的 URL 模式 <pattern> 有一个以 / 开头的 route。请删除这个斜线,因为它是不必要的。如果这个模式是以 include() 为目标,请确保 模式有一个尾部的 /
    • urls.W003:你的 URL 模式 <pattern> 有一个 name,包括一个 :。去掉冒号,以避免模糊的命名空间引用。
    • urls.E004:你的 URL 模式 <pattern> 无效。确保 urlpatterns 是一个 path() 和/或 实例的列表。
    • urls.W005:URL 命名空间 <namespace> 不是唯一的。你可能无法反查此命名空间中的所有 URL。
    • urls.E006MEDIA_URL / 的配置必须以斜线结束。
    • urls.E007:自定义 handlerXXX 视图 ''path.to.view' 没有使用正确的参数数(…)。
    • urls.E008:无法导入自定义 handlerXXX 视图 'path.to.view'
    • urls.E009: Your URL pattern <pattern> has an invalid view, pass <view>.as_view() instead of <view>.

    admin

    后台检查项均作为 admin 标签的一部分执行。

    以下检查项在每个通过后台站点注册的 (或其子类)上执行。

    • admin.E001raw_id_fields 的值必须是个列表或元组。
    • admin.E002: The value of raw_id_fields[n] refers to <field name>, which is not a field of <model>.
    • admin.E003raw_id_fields[n] 的值必须是个外键或一个多对多字段。
    • admin.E004fields 的值必须是列表或元组。
    • admin.E005fieldsetsfields 都是定制的。
    • admin.E007fieldsets 的值必须是个列表或元组。
    • admin.E008fieldsets[n] 的值必须是个列表或元组。
    • admin.E009fieldsets[n] 的值的长度必须是 2。
    • admin.E010fieldsets[n][1] 的值必须是个字典。
    • admin.E011fieldsets[n][1] 的值必须包含键 fields
    • admin.E012fieldsets[n][1] 中有重复字段。
    • admin.E013fields[n]/fieldsets[n][m] 不能包括 ManyToManyField <field name>,因为该字段手动指定了一个关系模型。
    • admin.E014exclude 的值必须是个列表或元组。
    • admin.E015exclude 的值必须包含重复字段。
    • admin.E016form 的值必须继承自 。
    • admin.E017filter_vertical 的值必须是个列表或元组。
    • admin.E018filter_horizontal 的值必须是个列表或元组。
    • admin.E019: The value of filter_vertical[n]/filter_horizontal[n] refers to <field name>, which is not a field of <model>.
    • admin.E020filter_vertical[n]/filter_horizontal[n] 的值必须是多对多字段。
    • admin.E021radio_fields 的值必须是一个字典。
    • admin.E022: The value of radio_fields refers to <field name>, which is not a field of <model>.
    • admin.E023 : radio_fields 的值指的是 <field name>,它不是 ForeignKey 的实例,也没有 choices 的定义。
    • admin.E024radio_fields[<field name>] 的值必须是 admin.HORIZONTALadmin.VERTICAL
    • admin.E025view_on_site 的值必须是可调用值或布尔值。
    • admin.E026prepopulated_fields 的值必须是一个字典。
    • admin.E027: The value of prepopulated_fields refers to <field name>, which is not a field of <model>.
    • admin.E028prepopulated_fields 的值指的是 <field name>,它不得是 DateTimeFieldForeignKeyOneToOneFieldManyToManyField 字段。
    • admin.E029prepopulated_fields[<field name>] 的值必须是一个列表或元组。
    • admin.E030: The value of prepopulated_fields refers to <field name>, which is not a field of <model>.
    • admin.E031ordering 的值必须是一个列表或元组。
    • admin.E032ordering 的值有随机排序标记 ?,但也有其他字段。
    • admin.E033: The value of ordering refers to <field name>, which is not a field of <model>.
    • admin.E034readonly_fields 的值必须是一个列表或元组。
    • admin.E035readonly_fields[n] 的值不是可调用对象,不是 <ModelAdmin class> 的属性,也不是 <model> 的属性。
    • admin.E036autocomplete_fields 的值必须是一个列表或元组。
    • admin.E037: The value of autocomplete_fields[n] refers to <field name>, which is not a field of <model>.
    • admin.E038autocomplete_fields[n] 的值必须是外键或多对多字段。
    • admin.E039:模型 <model> 的管理必须注册,才能由 <modeladmin>.autocomplete_fields 引用。
    • admin.E040<modeladmin> 必须定义 search_fields,因为 <other_modeladmin>.autocomplete_fields 引用了它。

    ModelAdmin

    对管理站点注册的任何 进行以下检查:

    • admin.E101save_as 的值必须是个布尔值。
    • admin.E102save_on_top 的值必须是个布尔值。
    • admin.E103inlines 的值必须是个列表或元组。
    • admin.E104<InlineModelAdmin class> 必须继承自 InlineModelAdmin
    • admin.E105<InlineModelAdmin class> 必须有个 model 属性。
    • admin.E106<InlineModelAdmin class>.model 的值必须是个 Model
    • admin.E107list_display 的值必须是个列表或元组。
    • admin.E108list_display[n] 的值指的是 <label>,而该值不是可调用对象,不是 <ModelAdmin class> 的属性,也不是 <model> 的属性或方法。
    • admin.E109list_display[n] 的值绝对不能是个 ManyToManyField 字段。
    • admin.E110list_display_links 的值必须是一个列表、一个元组或 None
    • admin.E111list_display_links[n] 的值指的是 <label>,而 list_display 中没有定义。
    • admin.E112list_filter 的值必须是一个列表或元组。
    • admin.E113list_filter[n] 的值必须继承自 ListFilter
    • admin.E114list_filter[n] 的值不得继承于 FieldListFilter
    • admin.E115list_filter[n][1] 的值必须继承自 FieldListFilter
    • admin.E116list_filter[n] 的值指的是 <label>,而该值并不指一个字段。
    • admin.E117list_select_related 的值必须是布尔值、元组或列表。
    • admin.E118list_per_page 的值必须是一个整数。
    • admin.E119list_max_show_all 的值必须是一个整数。
    • admin.E120list_editable 的值必须是一个列表或元组。
    • admin.E121: The value of list_editable[n] refers to <label>, which is not a field of <model>.
    • admin.E122list_editable[n] 的值指的是 <label>,而 list_display 中并不包含该值。
    • admin.E123list_editable[n] 的值不能同时出现在 list_editablelist_display_links 中。
    • admin.E124list_editable[n] 的值是指 list_display<label>)中的第一个字段,除非设置 list_display_links,否则不能使用。
    • admin.E125list_editable[n] 的值指的是 <field name>,不能通过管理编辑。
    • admin.E126search_fields 的值必须是一个列表或元组。
    • admin.E127date_hierarchy 的值指的是 <field name>,而该值并不指的是一个字段。
    • admin.E128date_hierarchy 的值必须是 DateFieldDateTimeField
    • admin.E129<modeladmin> 必须为 <action> 动作定义一个 has_<foo>_permission() 方法。
    • admin.E130<modeladmin> 中定义的行动的 __name__ 属性必须是唯一的。<name> 这个名称不是唯一的。

    InlineModelAdmin

    对任何 上注册为内联的 ModelAdmin 进行以下检查。

    • admin.E201:不能排除字段 <field name>,因为它是父模型 <app_label>.<model> 的外键。
    • admin.E202<model> 没有 ForeignKey<parent model>./ <model> 有一个以上 ForeignKey<parent model>。你必须指定一个 fk_name 属性。
    • admin.E203extra 的值必须是一个整数。
    • admin.E204max_num 的值必须是一个整数。
    • admin.E205min_num 的值必须是一个整数。
    • admin.E206formset 的值必须继承自 BaseModelFormSet

    GenericInlineModelAdmin

    以下检查将在任何 GenericInlineModelAdmin 上作为内联注册的 上执行。

    • admin.E301'ct_field' 引用了 <label>,这不是 <model> 上的一个字段。
    • admin.E302'ct_fk_field' 引用了 <label>,这不是 <model> 上的一个字段。
    • admin.E303<model> 没有 GenericForeignKey
    • admin.E304<model> 没有 GenericForeignKey,使用内容类型字段 <field name> 和对象 ID 字段 <field name>

    AdminSite

    对默认的 进行以下检查:

    • admin.E401django.contrib.contenttypes 必须在 中才能使用管理应用程序。
    • admin.E402:如果使用默认的认证后端,必须在 DjangoTemplates ()中启用 django.contrib.auth.context_processors.auth,才能使用管理程序。
    • admin.E403:必须在 中配置一个 django.template.backends.django.DjangoTemplates 实例,才能使用管理程序。
    • admin.E404django.contrib.message.context_processors.message 必须在 (TEMPLATES)中启用,才能使用管理程序。
    • admin.E405: 必须在 INSTALLED_APPS 中才能使用管理程序。
    • admin.E406: 必须在 INSTALLED_APPS 中才能使用管理程序。
    • admin.E408: 必须在 MIDDLEWARE 中才能使用管理应用程序。
    • admin.E409: 必须在 MIDDLEWARE 中才能使用管理应用程序。
    • admin.E410django.contrib.session.middleware.SessionMiddleware 必须在 中才能使用管理应用程序。
    • admin.W411:必须在 DjangoTemplates ()中启用 django.template.context_processors.request 才能使用管理员导航侧栏。

    auth

    • auth.E001REQUIRED_FIELDS 必须是一个列表或元组。
    • auth.E002REQUIRED_FIELDS 中不得包括名为 USERNAME_FIELD 的自定义用户模型字段。
    • auth.E003<field> 必须是唯一的,因为它被命名为 USERNAME_FIELD
    • auth.W004<field> 被命名为 USERNAME_FIELD,但它不是唯一的。
    • auth.E005:代号为 <codename> 的权限与模型 <model> 的内置权限发生冲突。
    • auth.E006:代号为 <codename> 的权限与模型 <model> 重复。
    • auth.E007:模型 <model> 的 必须最多 244 个字符,其内置的权限名最多只能是 255 个字符。
    • auth.E008:模型 <model> 的权限名 <name> 超过 255 个字符。
    • auth.C009<User model>.is_anonymous 必须是一个属性或属性,而不是方法。忽略这一点是一个安全问题,因为匿名用户将被视为经过认证的用户。
    • auth.C010<User model>.is_authenticated 必须是一个属性或属性,而不是方法。忽略这一点是一个安全问题,因为匿名用户将被视为经过认证的用户。
    • auth.E011: 模型 <model> 的名称最多只能是 93 个字符,其内置的权限名称最多只能是 100 个字符。
    • auth.E012:代号为 <codename> 的模型 <model> 的权限超过100个字符。

    contenttypes

    当一个模型包含 GenericForeignKeyGenericRelation 时,会进行以下检查:

    • contenttypes.E001GenericForeignKey 对象 ID 引用不存在的字段 <field>
    • contenttypes.E002GenericForeignKey 内容类型引用不存在的字段 <field>
    • contenttypes.E003<field> 不是一个 ForeignKey
    • contenttypes.E004<field> 不是一个指向 contenttypes.ContentTypeForeignKey
    • contenttypes.E005:模型名称最多只能是 100 个字符。

    postgres

    django.contrib.postgres 模型字段进行以下检查:

    • postgres.E001:数组的基础字段有错误:…
    • postgres.E002:数组的基础字段不能是有关系的字段。
    • postgres.E003<field> 缺省值应该是一个可调用对象,而不是一个实例,这样它就不会被所有字段实例共享。这个检查在 Django 3.1 中被改为 \``fields.E010`` [\](#id1)。

    sites

    对任何使用 CurrentSiteManager 的模型进行以下检查:

    • sites.E001CurrentSiteManager 找不到名为 <field name> 的字段。
    • sites.E002CurrentSiteManager 不能使用 <field>,因为它不是外键或多对多字段。

    以下检查验证 django.contrib.sites 是否正确配置:

    • sites.E101 : 的配置必须是一个整数。

    以下检查验证 django.contrib.staticfiles 是否正确配置:

    • staticfiles.E001: 配置不是元组或列表。
    • staticfiles.E002STATICFILES_DIRS 配置不应包含 配置。
    • staticfiles.W004: The directory <directory> in the STATICFILES_DIRS does not exist.