Django 1.8.2.dev20150513143415 documentation

首页 | 目录 | 索引 | 模块

«上一页 | 上 | 下一页»

System check framework

Django 1.7中的新功能。

系统检查框架是一组用于验证Django项目的静态检查。它检测常见问题并提供如何修复它们的提示。框架是可扩展的，因此您可以轻松添加自己的检查。

有关如何添加自己的检查并将其与Django的系统检查集成的详细信息，请参阅System check topic guide。

Builtin tags

Django的系统检查使用以下标记进行组织：

• models：检查管理模型，字段和管理器定义。
• signals：检查信号声明和处理程序注册。
• admin：检查任何管理网站声明。
• compatibility：标记版本升级的潜在问题。
• security：检查安全相关的配置。

某些检查可能会向多个标签注册。

Core system checks

Models

• models.E001：<swappable>的格式不是app_label.app_name。
• models.E002：<SETTING>引用<model>
• models.E003：该模型通过中间模型<app_label>.<model>具有两个多对多关系。
• models.E004：id只能用作字段名称，如果字段也设置为primary_key=True。
• models.E005: The field <field name> from parent model <model> clashes with the field <field name> from parent model <model>.
• models.E006: The field clashes with the field <field name> from model <model>.
• models.E007：字段 名称>具有列名称＆lt； column name＆gt；。
• models.E008：index_together必须是列表或元组。
• models.E009：所有index_together元素必须是列表或元组。
• models.E010：unique_together必须是列表或元组。
• models.E011：所有unique_together元素必须是列表或元组。
• models.E012：index_together/unique_together是指不存在的字段＆lt； field name＆gt； 。
• models.E013: index_together/unique_together refers to a ManyToManyField <field name>, but ManyToManyFields are not supported for that option.
• models.E014：ordering必须是元组或列表（即使您只想按照一个字段排序）。
• models.E015: ordering refers to the non-existent field <field name>.
• models.E016: index_together/unique_together refers to field <field_name> which is not local to model <model>.
• models.E017：代理模型<model>包含模型字段。
• models.E018：对于字段<field>，自动生成的列名称过长。对于数据库<alias>，最大长度为 长度>
• models.E019：M2M字段＆lt； M2M 字段>的自动生成列名太长。对于数据库<alias>，最大长度为 长度>
• models.E020：<model>.check()类方法当前被覆盖。

Fields

• fields.E001：字段名称不能以下划线结尾。
• fields.E002：字段名称不能包含"__"。
• fields.E003：pk是不能用作字段名称的保留字。
• fields.E004：choices必须是可迭代的（例如，列表或元组）。
• fields.E005：choices必须是可迭代的返回（实际 值， / t6> 可读 名称）。
• fields.E006：db_index必须是None，True或False。
• fields.E007：主键不能有null=True。
• fields.E100：AutoField必须设置primary_key = True。
• fields.E110：BooleanField不接受空值。
• fields.E120：CharField必须定义max_length属性。
• fields.E121：max_length必须为正整数。
• fields.W122：max_length与IntegerField配合使用时将被忽略。
• fields.E130：DecimalField必须定义decimal_places属性。
• fields.E131：decimal_places必须是非负整数。
• fields.E132：DecimalField必须定义max_digits属性。
• fields.E133：max_digits必须是非负整数。
• fields.E134：max_digits必须大于或等于decimal_places。
• fields.E140：FilePathField必须将allow_files或allow_folders设置为True。
• fields.E150：GenericIPAddressField不能接受空值，如果不允许空值，因为空值存储为null。
• fields.E160：选项auto_now，auto_now_add和default是互斥的。这些选项中只能有一个存在。
• fields.W161：提供固定的默认值。
• fields.W900：IPAddressField已被弃用。对它的支持（除了历史迁移）将在Django 1.9中删除。

File Fields

• fields.E200：unique不是FileField的有效参数。
• fields.E201：primary_key不是FileField的有效参数。
• fields.E210：由于未安装枕头，无法使用ImageField。

Related Fields

• fields.E300：字段定义与模型<model>的关系，未安装或是抽象的。
• fields.E301：字段定义了与已换出的模型<model>的关系。
• fields.E302：字段 名称>的访问者与字段；字段 name＆gt；。
• fields.E303：字段 名称>的反向查询名称与字段＆lt； field name＆gt；。
• fields.E304：字段名称 名称>与；字段 name＆gt；。
• fields.E305：字段名称 名称>与反向查询名称＆lt； field name＆gt；。
• fields.E306：相关名称必须是有效的Python标识符或以'+'结尾。
• fields.E310: None of the fields <field1>, <field2>, ... on model <model> have a unique=True constraint.
• fields.E311：<model>必须设置unique=True，因为它由ForeignKey引用。
• fields.E320：字段指定on_delete=SET_NULL，但不能为空。
• fields.E321：该字段指定on_delete=SET_DEFAULT，但没有默认值。
• fields.E330：ManyToManyField不能是唯一的。
• fields.E331：字段通过模型<model>指定多对多关系，尚未安装。
• fields.E332：具有中间表的多对多字段不能是对称的。
• fields.E333：该模型用作<model>的中间模型，但它具有多于两个外键到<model>您必须通过through_fields关键字参数指定Django应使用的两个外键。
• fields.E334：该模型被<model>用作中间模型，但是它具有来自<model>您必须通过through_fields关键字参数指定Django应使用的外键。
• fields.E335：该模型用作<model>的中间模型，但它具有多于一个外键<model>您必须通过through_fields关键字参数指定Django应使用的外键。
• fields.E336: The model is used as an intermediary model by <model>, but it does not have foreign key to <model> or <model>.
• fields.E337：字段指定through_fields，但不提供应通过<model>
• fields.E338: The intermediary model <through model> has no field <field name>.
• fields.E339: <model>.<field name> is not a foreign key to <model>.
• fields.W340：null对ManyToManyField没有影响。
• fields.W341：ManyToManyField不支持validators。
• fields.W342：在ForeignKey上设置unique=True与使用OneToOneField具有相同的效果。

Signals

• 信号.E001：<handler>连接到<signal>信号，延迟参考<model>发件人，尚未安装。

Backwards Compatibility

执行以下检查以警告用户由于版本升级可能发生的任何潜在问题。

• 1_6.W001：某些项目单元测试可能无法按预期执行。由于误报，此检查在Django 1.8中已删除。
• 1_6.W002：BooleanField没有默认值。由于误报，此检查在Django 1.8中已删除。
• 1_7.W001：Django 1.7更改了MIDDLEWARE_CLASSES.django.contrib.sessions.middleware.SessionMiddleware，django.contrib.auth.middleware.AuthenticationMiddleware和django.contrib.messages.middleware.MessageMiddleware如果你的项目需要这些中间件，那么你应该配置这个设置。

Admin

管理员检查全部作为admin标记的一部分执行。

对在管理站点注册的任何ModelAdmin（或子类）执行以下检查：

• admin.E001：raw_id_fields的值必须是列表或元组。
• admin.E002：raw_id_fields[n]的值指的是＆lt； field name＆gt； / t3>，其不是<model>的属性。
• admin.E003：raw_id_fields[n]的值必须是ForeignKey或ManyToManyField。
• admin.E004：fields必须是列表或元组。
• admin.E005：指定了fieldsets和fields。
• admin.E006：fields包含重复字段。
• admin.E007：fieldsets的值必须是列表或元组。
• admin.E008：fieldsets[n]的值必须是列表或元组。
• admin.E009：fieldsets[n]的值必须为2。
• admin.E010：fieldsets[n][1]的值必须是字典。
• admin.E011：fieldsets[n][1]的值必须包含键fields。
• admin.E012：fieldsets[n][1]中有重复字段。
• admin.E013：fields[n]/fieldsets[n][m]不能包含ManyToManyField ＆lt； field name＆gt；，因为该字段手动指定关系模型。
• admin.E014：exclude的值必须是列表或元组。
• admin.E015：exclude的值包含重复字段。
• admin.E016：form的值必须继承BaseModelForm。
• admin.E017：filter_vertical的值必须是列表或元组。
• admin.E018：filter_horizontal的值必须是列表或元组。
• admin.E019: The value of filter_vertical[n]/filter_vertical[n] refers to <field name>, which is not an attribute of <model>.
• admin.E020：filter_vertical[n]/filter_vertical[n]的值必须是ManyToManyField。
• admin.E021：radio_fields的值必须是字典。
• admin.E022：radio_fields的值是指＆lt； field name＆gt； ，其不是<model>的属性。
• admin.E023：radio_fields的值指的是＆lt； field name＆gt； ，其不是ForeignKey，并且没有choices定义。
• admin.E024：radio_fields [ 名称>]的值必须为admin.HORIZONTAL或admin.VERTICAL。
• admin.E025：view_on_site的值必须是可调用值或布尔值。
• admin.E026：prepopulated_fields的值必须是字典。
• admin.E027：prepopulated_fields的值指向＆lt； field name＆gt； ，其不是<model>的属性。
• admin.E028：prepopulated_fields的值是指＆lt； field name＆gt； ，它不能是DateTimeField，ForeignKey或ManyToManyField。
• admin.E029：prepopulated_fields [ 名称>]的值必须是列表或元组。
• admin.E030：prepopulated_fields的值指向＆lt； field name＆gt； ，其不是<model>的属性。
• admin.E031：ordering的值必须是列表或元组。
• admin.E032：ordering的值具有随机排序标记?，但也包含其他字段。
• admin.E033：ordering的值指的是＆lt； field name＆gt； ，其不是<model>的属性。
• admin.E034：readonly_fields的值必须是列表或元组。
• admin.E035：readonly_fields[n]的值不是可调用的，属性＆lt； ModelAdmin class＆gt ；或属性<model>。

ModelAdmin

对在管理站点注册的任何ModelAdmin执行以下检查：

• admin.E101：save_as的值必须是布尔值。
• admin.E102：save_on_top的值必须是布尔值。
• admin.E103：inlines的值必须是列表或元组。
• admin.E104：＆lt； InlineModelAdmin class＆gt；必须继承自BaseModelAdmin。
• admin.E105：＆lt； InlineModelAdmin class＆gt；必须具有model属性。
• admin.E106：＆lt； InlineModelAdmin class＆gt； .model的值必须为Model
• admin.E107：list_display的值必须是列表或元组。
• admin.E108：list_display[n]的值是指<label>，不是可调用的，属性 ＆lt； ModelAdmin class＆gt；或<model>上的属性或方法。
• admin.E109：list_display[n]的值不能是ManyToManyField。
• admin.E110：list_display_links的值必须是列表，元组或None。
• admin.E111: The value of list_display_links[n] refers to <label>, which is not defined in list_display.
• admin.E112：list_filter的值必须是列表或元组。
• admin.E113：list_filter[n]的值必须继承ListFilter。
• admin.E114：list_filter[n]的值不能继承FieldListFilter。
• admin.E115：list_filter[n][1]的值必须继承FieldListFilter。
• admin.E116：list_filter[n]的值指的是不参考字段的<label>。
• admin.E117：list_select_related的值必须是布尔值，元组或列表。
• admin.E118：list_per_page的值必须为整数。
• admin.E119：list_max_show_all的值必须为整数。
• admin.E120：list_editable的值必须是列表或元组。
• admin.E121：list_editable[n]的值指代<label>，其不是<model>。
• admin.E122: The value of list_editable[n] refers to <label>, which is not contained in list_display.
• admin.E123：list_editable[n]的值不能同时位于list_editable和list_display_links中。
• admin.E124: The value of list_editable[n] refers to the first field in list_display (<label>), which cannot be used unless list_display_links is set.
• admin.E125：list_editable[n]的值指向＆lt； field name＆gt； / t3>，这是不能通过管理员编辑。
• admin.E126：search_fields的值必须是列表或元组。
• admin.E127：date_hierarchy的值指＆lt； field name＆gt； ，其不是<model>的属性。
• admin.E128：date_hierarchy的值必须是DateField或DateTimeField。

InlineModelAdmin

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

• admin.E201：无法排除字段＆lt； field name＆gt； 父模型<app_label>.<model>。
• admin.E202: <model> has no ForeignKey to <parent model>./ <model> has more than one ForeignKey to <parent model>.
• admin.E203：extra的值必须为整数。
• admin.E204：max_num的值必须为整数。
• admin.E205：min_num的值必须为整数。
• admin.E206：formset的值必须继承BaseModelFormSet。

GenericInlineModelAdmin

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

• admin.E301：'ct_field'参考<label>，不是<model>
• admin.E302：'ct_fk_field'参考<label>，不是<model>
• admin.E303：<model>没有GenericForeignKey。
• admin.E304: <model> has no GenericForeignKey using content type field <field name> and object ID field <field name>.

Auth

• auth.E001：REQUIRED_FIELDS必须是列表或元组。
• auth.E002：自定义用户模型的名为USERNAME_FIELD的字段不能包含在REQUIRED_FIELDS中。
• auth.E003：<field>必须是唯一的，因为它被命名为USERNAME_FIELD。
• auth.W004：<field>命名为USERNAME_FIELD，但不是唯一的。

Content Types

当模型包含GenericForeignKey或GenericRelation时，将执行以下检查：

• contenttypes.E001：GenericForeignKey对象ID引用不存在的字段<field>。
• contenttypes.E002：GenericForeignKey内容类型引用不存在的字段<field>。
• contenttypes.E003：<field>不是ForeignKey。
• contenttypes.E004：<field>不是ForeignKey至contenttypes.ContentType。

Security

安全检查不会使您的网站安全。他们不审计代码，做入侵检测，或做任何特别复杂的事情。相反，他们帮助执行自动化，低挂的水果清单。它们可以帮助您记住提高网站安全性的简单操作。

其中一些检查可能不适合您的特定部署配置。例如，如果您在负载平衡器中执行HTTP到HTTPS重定向，则会不经常警告您未启用SECURE_SSL_REDIRECT。使用SILENCED_SYSTEM_CHECKS可停止不需要的检查。

如果您使用check命令的--deploy选项，将运行以下检查：

• security.W001：您在MIDDLEWARE_CLASSES中没有django.middleware.security.SecurityMiddleware，因此SECURE_HSTS_SECONDS SECURE_CONTENT_TYPE_NOSNIFF，SECURE_BROWSER_XSS_FILTER和SECURE_SSL_REDIRECT设置将不起作用。
• security.W002: You do not have django.middleware.clickjacking.XFrameOptionsMiddleware in your MIDDLEWARE_CLASSES, so your pages will not be served with an 'x-frame-options' header. 除非您的网站有足够的理由在框架中投放，否则您应该考虑启用此标头以帮助防止点击劫持攻击。
• security.W003：您似乎未通过中间件使用Django的内置跨站点请求防伪保护（django.middleware.csrf.CsrfViewMiddleware不在您的MIDDLEWARE_CLASSES）。启用中间件是确保您不留下任何漏洞的最安全的方法。
• security.W004：您尚未为SECURE_HSTS_SECONDS设置设置值。如果您的整个网站仅通过SSL投放，您可以考虑设置值并启用HTTP Strict Transport Security。请务必先阅读文档；使HSTS不小心会导致严重的，不可逆的问题。
• security.W005：您尚未将SECURE_HSTS_INCLUDE_SUBDOMAINS设置设置为True。否则，您的网站可能容易受到通过与子域的不安全连接的攻击。如果您确定域的所有子域都应通过SSL专门投放，则只需将其设置为True即可。
• security.W006：您的SECURE_CONTENT_TYPE_NOSNIFF设置未设置为True，因此您的网页不会显示x-content-type-options： nosniff'标题。您应该考虑启用此标头，以防止浏览器不正确地识别内容类型。
• security.W007：您的SECURE_BROWSER_XSS_FILTER设置未设置为True，因此您的网页不会投放x-xss-protection： 1； mode = block'您应该考虑启用此标头来激活浏览器的XSS过滤，并帮助防止XSS攻击。
• security.W008：您的SECURE_SSL_REDIRECT设置未设置为True。除非您的网站应通过SSL和非SSL连接提供，否则您可能要将此设置设置为True，或者配置负载平衡器或反向代理服务器将所有连接重定向到HTTPS。
• security.W009：您的SECRET_KEY少于50个字符或少于5个唯一字符。请生成一个长且随机的SECRET_KEY，否则许多Django的安全关键功能将容易受到攻击。
• security.W010: You have django.contrib.sessions in your INSTALLED_APPS but you have not set SESSION_COOKIE_SECURE to True. 使用安全的会话cookie使得网络流量嗅探器更难以劫持用户会话。
• security.W011: You have django.contrib.sessions.middleware.SessionMiddleware in your MIDDLEWARE_CLASSES, but you have not set SESSION_COOKIE_SECURE to True. 使用安全的会话cookie使得网络流量嗅探器更难以劫持用户会话。
• security.W012：SESSION_COOKIE_SECURE未设置为True。使用安全的会话cookie使得网络流量嗅探器更难以劫持用户会话。
• security.W013：您在INSTALLED_APPS中有django.contrib.sessions，但尚未将SESSION_COOKIE_HTTPONLY设置为True。使用HttpOnly会话Cookie会使跨站点脚本攻击更难以劫持用户会话。
• security.W014: You have django.contrib.sessions.middleware.SessionMiddleware in your MIDDLEWARE_CLASSES, but you have not set SESSION_COOKIE_HTTPONLY to True. 使用HttpOnly会话Cookie会使跨站点脚本攻击更难以劫持用户会话。
• security.W015：SESSION_COOKIE_HTTPONLY未设置为True。使用HttpOnly会话Cookie会使跨站点脚本攻击更难以劫持用户会话。
• security.W016：CSRF_COOKIE_SECURE未设置为True。使用安全的CSRF cookie使得网络流量嗅探器更难窃取CSRF令牌。
• security.W017：CSRF_COOKIE_HTTPONLY未设置为True。使用HttpOnly CSRF Coo​​kie使跨站点脚本攻击更难窃取CSRF令牌。
• security.W018：在部署中，您不应将DEBUG设置为True。
• security.W019：您在MIDDLEWARE_CLASSES中有django.middleware.clickjacking.XFrameOptionsMiddleware，但未设置X_FRAME_OPTIONS到'DENY'。默认值为'SAMEORIGIN'，但除非您的网站有足够的理由在框架中为其自身的其他部分提供服务，否则应将其更改为'DENY'。

Sites

使用CurrentSiteManager在任何模型上执行以下检查：

• sites.E001: CurrentSiteManager could not find a field named <field name>.
• sites.E002：CurrentSiteManager不能使用<field>，因为它不是ForeignKey或ManyToManyField。

Database

MySQL

如果您使用MySQL，将执行以下检查：

• mysql.E001：MySQL不允许唯一的CharField具有max_length> 255。

最后更新：

2015年5月13日

«上一页 | 上 | 下一页»