{"title":"O framework de verificação do sistema.","version":"4.2","locale":"pt-br","docname":"ref/checks","url":"/pt-br/4.2/ref/checks/","canonical":"https://djangodocs.dev/pt-br/4.2/ref/checks/","summary":"O framework de verificação do sistema é um conjunto de verificações estáticas para validação de projetos Django. Ele detecta problemas comuns e fornece dicas de…","html":"

O framework de verificação do sistema.Link para este cabeçalho#

\n

O framework de verificação do sistema é um conjunto de verificações estáticas para validação de projetos Django. Ele detecta problemas comuns e fornece dicas de como arrumá-los. O framework é extensível e você pode facilmente adicionar suas próprias validações.

\n

Para detalhes de como adicionar suas próprias verificações e integrar isso com os sistema de verificação do Django, veja o Tópico sistema de verificação do giua..

\n
\n

Referência da APILink para este cabeçalho#

\n
\n

CheckMessageLink para este cabeçalho#

\n
\n
\nclass CheckMessage(level, msg, hint=None, obj=None, id=None)Link para esta definição#
\n
\n\n

Os alertas e erros emitidos pelo sistema de verificação devem ser uma instância de CheckMessage. Uma instância encapsula um único erro ou aviso. Ele também fornece contexto e dicas aplicáveia a mensagem, e um identificador único que é usado para propósitos de filtragem.

\n

Os argumentos do Construtor são:

\n
\n
level

A gravidade da mensagem. Use um dos valores pré-definidos: DEBUG, INFO, WARNING, ERROR, CRITICAL. Se o nível é maior ou igual a ERROR`, então o Django irá impedir que comandos de gerenciamento sejam exeutados. Mensagens com nível menor que ``ERROR (ex. alertas) são reportados no console, mas pode ser silenciados.

\n
\n
msg

Uma string curta (menor que 80 caracetres) descrevendo o problema. A string não deve conter outras linhas.

\n
\n
hint

Uma string de uma única linha que forneça uma dica para arrumar o problema. Se não pode ser fornecida uma dica, ou a dica é auto-evidente baseado na mensagem de erro, a dica pode ser omitida, ou o valor None pode ser usado.

\n
\n
obj

Opcional. Um objeto que fornece contexto para a mensagem (por exemplo, o modelo onde o problema foi descoberto). O objeto deve ser um modelo, campo ou gerenciador ou qualquer outro objeto que defina um método __str__(). O método é usado durante a exibição de todas as mensagens e seu resultado precede a mensagem.

\n
\n
id

String opcional. Um identificador único para esse problema. Identificadores devem seguir o formato padrão applabel.X001, onde X é uma das letras de CEWID, indicando a gravidade da mensagem (C para crítico, E para erro e assim por diante). O número pode ser alocado pela aplicação, mas deve ser único dentro daquela aplicação.

\n
\n
\n

Existem subclasses para tornar a criação de mensagens de níveis comuns mais fácil. Quando usá-los você pode omitir o argumento level porque ele está implícito no nome da classe.

\n
\n
\nclass Debug(msg, hint=None, obj=None, id=None)Link para esta definição#
\n
\n\n
\n
\nclass Info(msg, hint=None, obj=None, id=None)Link para esta definição#
\n
\n\n
\n
\nclass Warning(msg, hint=None obj=None, id=None)Link para esta definição#
\n
\n\n
\n
\nclass Error(msg, hint=None, obj=None, id=None)Link para esta definição#
\n
\n\n
\n
\nclass Critical(msg, hint=None, obj=None, id=None)Link para esta definição#
\n
\n\n
\n
\n
\n

Tags embutidasLink para este cabeçalho#

\n

As verificações do sistema do Django estão organizadas usando as seguintes tags:

\n\n

Algumas verificações talvez sejam registradas com múltiplas tags.

\n
\n
\n

Verificações do núcleo do sistemaLink para este cabeçalho#

\n
\n

Suporte assíncronoLink para este cabeçalho#

\n

As seguintes checagens verificarão seu setup para Suporte assíncrono:

\n\n
\n
\n

RetrocompatibilidadeLink para este cabeçalho#

\n

Testes de compatibilidade notificam sobre problemas que podem ocorrer após atualizar o Django.

\n\n
\n
\n

CachesLink para este cabeçalho#

\n

As verificações seguintes averiguam se seu CACHES está configurado corretamente:

\n\n
\n
\n

Banco de dadosLink para este cabeçalho#

\n
\n

MySQL e MariaDBLink para este cabeçalho#

\n

If you’re using MySQL or MariaDB, the following checks will be performed:

\n
    \n

  • mysql.E001: MySQL/MariaDB does not allow unique CharFields to have a\nmax_length > 255. This check was changed to mysql.W003 in Django\n3.1 as the real maximum size depends on many factors.

    • \n

  • mysql.W002: MySQL/MariaDB Strict Mode is not set for database connection\n<alias>. See also Setting sql_mode.

    • \n

  • mysql.W003: MySQL/MariaDB may not allow unique CharFields to have a\nmax_length > 255.

    • \n
\n
\n
\n
\n

Gerenciando arquivosLink para este cabeçalho#

\n

The following checks verify your setup for Gerenciando arquivos:

\n\n
\n
\n

Campos ModelosLink para este cabeçalho#

\n\n
\n

Campos de ArquivoLink para este cabeçalho#

\n
    \n

  • fields.E200: unique não é um argumento válido para FileField. Esta verificação foi removida no Django 1.11.

    • \n

  • fields.E201: primary_key não é um argumento válido para um FileField.

    • \n

  • fields.E202: FileField’s upload_to argument must be a relative\npath, not an absolute path.

    • \n

  • fields.E210: Não é possível usar ImageField porque o Pillow não está instalado.

    • \n
\n
\n
\n

Campos relacionadosLink para este cabeçalho#

\n
    \n

  • fields.E300: Campo define uma relação com o modelo <model>, o qual ou não está instalado, ou é abstrato.

    • \n

  • fields.E301: Field defines a relation with the model\n<app_label>.<model> which has been swapped out.

    • \n

  • fields.E302: Reverse accessor <related model>.<accessor name> for\n<app_label>.<model>.<field name> clashes with field name\n<app_label>.<model>.<field name>.

    • \n

  • fields.E303: Reverse query name for <app_label>.<model>.<field name>\nclashes with field name <app_label>.<model>.<field name>.

    • \n

  • fields.E304: Reverse accessor <related model>.<accessor name> for\n<app_label>.<model>.<field name> clashes with reverse accessor for\n<app_label>.<model>.<field name>.

    • \n

  • fields.E305: Reverse query name for <app_label>.<model>.<field name>\nclashes with reverse query name for <app_label>.<model>.<field name>.

    • \n

  • fields.E306: The name <name> is invalid related_name for field\n<model>.<field name>.

    • \n

  • fields.E307: O campo <app label>.<model>.<field name> foi declarado com uma referência “lazy” para <app label>.<model>, mas a aplicação <app label> não está instalada ou não fornece o modelo <model>.

    • \n

  • fields.E308: Reverse query name <related query name> must not end\nwith an underscore.

    • \n

  • fields.E309: Reverse query name <related query name> must not contain\n'__'.

    • \n

  • fields.E310: No subset of the fields <field1>, <field2>, … on\nmodel <model> is unique.

    • \n

  • fields.E311: <model>.<field name> must be unique because it is\nreferenced by a ForeignKey.

    • \n

  • fields.E312: The to_field <field name> doesn’t exist on the\nrelated model <app label>.<model>.

    • \n

  • fields.E320: Campo especifica on_delete=SET_NULL, mas não pode ser nulo.

    • \n

  • fields.E321: O campo especifíca on_delete=SET_DEFAULT, mas não tem um valor padrão.

    • \n

  • fields.E330: ManyToManyFields não pode ser único.

    • \n

  • fields.E331: O campo especifíca uma relação como muitos-para-muitos através do modelo <model>, o qual não foi instalado.

    • \n

  • fields.E332: Many-to-many fields with intermediate tables must not be\nsymmetrical. This check appeared before Django 3.0.

    • \n

  • fields.E333: O modelo é usado como um modelo intermediário pelo <model>, mas este tem mais de duas chaves estrangeiras para <model>, o que é ambíguo. Você deve especificar qual das duas chaves estrangeiras devem ser usadas pelo Django através do argumento through_fields.

    • \n

  • fields.E334: O modelo é usado como um modelo intermediário pelo <model>, mas este tem mais de uma chave estrangeira para <model>, o que é ambíguo. Você deve especificar qual das duas chaves estrangeiras devem ser usadas pelo Django através do argumento through_fields.

    • \n

  • fields.E335: O modelo é usado como um modelo intermediário pelo <model>, mas este tem mais de uma chave estrangeira para <model>, o que é ambíguo. Você deve especificar qual das duas chaves estrangeiras devem ser usadas pelo Django através do argumento through_fields.

    • \n

  • fields.E336: O modelo é usado como um modelo intermediário pelo <model>, mas este não tem uma chave-estrangeira para <model> ou <model>.

    • \n

  • fields.E337: O campo especifíca through_fields mas não fornece os nomes dos dois campos de ligação que deve ser usados para a relação através do <model>.

    • \n

  • fields.E338: O modelo intermediário <through model> não tem o campo <field name>.

    • \n

  • fields.E339: <model>.<field name> não é uma chave estrangeira para <model>.

    • \n

  • fields.E340: The field’s intermediary table <table name> clashes with\nthe table name of <model>/<model>.<field name>.

    • \n

  • fields.W340: null não tem efeito no ManyToManyField.

    • \n

  • fields.W341: ManyToManyField não dá suporte para validators.

    • \n

  • fields.W342: Definir unique=True para uma ForeignKey tem o mesmo efeito quanto usar um OneToOneField.

    • \n

  • fields.W343: limit_choices_to has no effect on ManyToManyField\nwith a through model. This check appeared before Django 4.0.

    • \n

  • fields.W344: The field’s intermediary table <table name> clashes with\nthe table name of <model>/<model>.<field name>.

    • \n

  • fields.W345: related_name has no effect on ManyToManyField with a\nsymmetrical relationship, e.g. to “self”.

    • \n

  • fields.W346: db_comment has no effect on ManyToManyField.

    • \n
\n
\n
\n
\n

ModelsLink para este cabeçalho#

\n\n
\n
\n

SegurançaLink para este cabeçalho#

\n

The security checks do not make your site secure. They do not audit code, do\nintrusion detection, or do anything particularly complex. Rather, they help\nperform an automated, low-hanging-fruit checklist, that can help you to improve\nyour site’s security.

\n

Algumas dessas verificações talvez não sejam apropriadas para uma configuração de implantação particular. Por exemlo, se você faz redirecionamento do HTTP para HTTPS em um balanceador de carga, isso pode ser irritante de ser constantemente alertado sobre não ter habilitado o SECURE_SSL_REDIRECT. Use o SILENCED_SYSTEM_CHECKS para silenciar verificações desnecessárias.

\n

As seguintes verificações são executadas se você usa a opção check --deploy:

\n\n

The following checks verify that your security-related settings are correctly\nconfigured:

\n\n
\n
\n

SignalsLink para este cabeçalho#

\n\n
\n
\n

TemplatesLink para este cabeçalho#

\n

As verificações seguintes averiguam se sua definição de TEMPLATES está corretamente configurada.

\n\n
\n
\n

TranslationLink para este cabeçalho#

\n

The following checks are performed on your translation configuration:

\n\n
\n
\n

URLsLink para este cabeçalho#

\n

As verificações seguintes são realizadas na sua configuração de URL:

\n\n
\n
\n
\n

contrib app checksLink para este cabeçalho#

\n
\n

adminLink para este cabeçalho#

\n

Verificações do Admin são todas realizadas como parte da etiqueta admin.

\n

As seguintes verificações sào realizadas em qualquer ModelAdmin (ou subclasse) que está registrada com o site Admin:

\n\n
\n

ModelAdminLink para este cabeçalho#

\n

A verificações seguintes são realizadas para qualquer ModelAdmin que é registrada com site Admin:

\n
    \n

  • admin.E101: O valor de save_as deve ser um booleano.

    • \n

  • admin.E102: O valor de save_on_top deve ser um booleano.

    • \n

  • admin.E103: O valor de inlines deve ser uma lista de tuplas.

    • \n

  • admin.E104: <InlineModelAdmin class> must inherit from\nInlineModelAdmin.

    • \n

  • admin.E105: <InlineModelAdmin class> deve ter um atributo model.

    • \n

  • admin.E106: O valor de <InlineModelAdmin class>.model deve ser um Model.

    • \n

  • admin.E107: O valor de list_display deve ser uma lista de tuplas.

    • \n

  • admin.E108: O valor de list_display[n] referencia a <label>, o qual não é um “callable”, um atributo de <ModelAdmin class>, ou um atributo ou método do <model>.

    • \n

  • admin.E109: O valor de list_display[n] precisa ser um campo ManyToManyField.

    • \n

  • admin.E110: O valor de list_display_links deve ser uma lista, uma tupla, ou None.

    • \n

  • admin.E111: O valor de list_display_links[n] referencia a <label>, o qual não é definido na list_display.

    • \n

  • admin.E112: O valor de list_filter deve ser uma lista de tuplas.

    • \n

  • admin.E113: O valor de list_filter[n] deve herdar de ListFilter.

    • \n

  • admin.E114: O valor de list_filter[n] não deve herdar de FieldListFilter.

    • \n

  • admin.E115: O valor de list_filter[n][1] deve herdar de FieldListFilter.

    • \n

  • admin.E116: O valor de list_filter[n] refere a <label>, o qual não refere a um campo.

    • \n

  • admin.E117: O valor de list_select_related deve ser um booleano, tuplas ou lista.

    • \n

  • admin.E118: O valor de list_per_page deve ser um inteiro.

    • \n

  • admin.E119: O valor de list_max_show_all deve ser um inteiro.

    • \n

  • admin.E120: O valor de list_editable deve ser uma lista de tuplas.

    • \n

  • admin.E121: The value of list_editable[n] refers to <label>,\nwhich is not a field of <model>.

    • \n

  • admin.E122: O valor de list_editable[n] refere a <label>, o qual não está contido em list_display.

    • \n

  • admin.E123: O valor de list_editable[n] não pode estar em ambos list_editable e list_display_links.

    • \n

  • admin.E124: O valor de list_editable[n] refere ao primeiro campo em list_display (<label>), o qual não pode ser usado a menos que list_display_links seja definido.

    • \n

  • admin.E125: O valor de list_editable[n] refere a <field name>, o qual não é editável através do admin.

    • \n

  • admin.E126: O valor de search_fields deve ser uma lista de tuplas.

    • \n

  • admin.E127: The value of date_hierarchy refers to <field name>,\nwhich does not refer to a Field.

    • \n

  • admin.E128: O valor de date_hierarchy deve ser um DateField ou DateTimeField.

    • \n

  • admin.E129: <modeladmin> must define a has_<foo>_permission()\nmethod for the <action> action.

    • \n

  • admin.E130: __name__ attributes of actions defined in\n<modeladmin> must be unique. Name <name> is not unique.

    • \n
\n
\n
\n

InlineModelAdminLink para este cabeçalho#

\n

As verificações seguintes são realizadas em qualquer InlineModelAdmin que esteja registrado como uma “inline” na ModelAdmin.

\n
    \n

  • admin.E201: Não pode excluir o campo <field name>, porque ele é a chave-estrangeira para o modelo <app_label>.<model>.

    • \n

  • admin.E202: <model> has no ForeignKey to <parent model>./\n<model> has more than one ForeignKey to <parent model>. You must\nspecify a fk_name attribute.

    • \n

  • admin.E203: O valor de extra deve ser um inteiro.

    • \n

  • admin.E204: O valor de max_num deve ser um inteiro.

    • \n

  • admin.E205: O valor de min_num deve ser um inteiro.

    • \n

  • admin.E206: O valor de formset deve herdar de BaseModelFormSet.

    • \n
\n
\n
\n

GenericInlineModelAdminLink para este cabeçalho#

\n

As seguintes verificações são realizadas sobre qualquer GenericInlineModelAdmin que esteja registrado como “inline” no ModelAdmin.

\n
    \n

  • admin.E301: 'ct_field' referencia a <label>, o qual não é um campo no <model>.

    • \n

  • admin.E302: 'ct_fk_field' referencia <label>, o qual não é um campo no <model>.

    • \n

  • admin.E303: <model> não tem GenericForeignKey.

    • \n

  • admin.E304: <model> não tem GenericForeignKey usando o campo de tipo de conteúdo <field name> e um campo de ID do objeto <field name>.

    • \n
\n
\n
\n

AdminSiteLink para este cabeçalho#

\n

As seguintes verificações são realizadas na AdminSite: padrão

\n\n
\n
\n
\n

authLink para este cabeçalho#

\n\n
\n
\n

contenttypesLink para este cabeçalho#

\n

As verificação seguintes são realizadas quando um modelo contém um GenericForeignKey ou GenericRelation:

\n\n
\n
\n

postgresLink para este cabeçalho#

\n

The following checks are performed on django.contrib.postgres model\nfields:

\n\n
\n
\n

sitesLink para este cabeçalho#

\n

As verificações seguintes são realizadas em qualquer modelo usando uma CurrentSiteManager:

\n\n

The following checks verify that django.contrib.sites is correctly\nconfigured:

\n\n
\n
\n

staticfilesLink para este cabeçalho#

\n

The following checks verify that django.contrib.staticfiles is correctly\nconfigured:

\n\n
\n
","rootId":"system-check-framework","toc":[{"title":"Referência da API","anchor":"api-reference","children":[{"title":"CheckMessage","anchor":"checkmessage","children":[]}]},{"title":"Tags embutidas","anchor":"builtin-tags","children":[]},{"title":"Verificações do núcleo do sistema","anchor":"core-system-checks","children":[{"title":"Suporte assíncrono","anchor":"asynchronous-support","children":[]},{"title":"Retrocompatibilidade","anchor":"backwards-compatibility","children":[]},{"title":"Caches","anchor":"caches","children":[]},{"title":"Banco de dados","anchor":"database","children":[{"title":"MySQL e MariaDB","anchor":"mysql-and-mariadb","children":[]}]},{"title":"Gerenciando arquivos","anchor":"managing-files","children":[]},{"title":"Campos Modelos","anchor":"model-fields","children":[{"title":"Campos de Arquivo","anchor":"file-fields","children":[]},{"title":"Campos relacionados","anchor":"related-fields","children":[]}]},{"title":"Models","anchor":"models","children":[]},{"title":"Segurança","anchor":"security","children":[]},{"title":"Signals","anchor":"signals","children":[]},{"title":"Templates","anchor":"templates","children":[]},{"title":"Translation","anchor":"translation","children":[]},{"title":"URLs","anchor":"urls","children":[]}]},{"title":"contrib app checks","anchor":"contrib-app-checks","children":[{"title":"admin","anchor":"admin","children":[{"title":"ModelAdmin","anchor":"modeladmin","children":[]},{"title":"InlineModelAdmin","anchor":"inlinemodeladmin","children":[]},{"title":"GenericInlineModelAdmin","anchor":"genericinlinemodeladmin","children":[]},{"title":"AdminSite","anchor":"adminsite","children":[]}]},{"title":"auth","anchor":"auth","children":[]},{"title":"contenttypes","anchor":"contenttypes","children":[]},{"title":"postgres","anchor":"postgres","children":[]},{"title":"sites","anchor":"sites","children":[]},{"title":"staticfiles","anchor":"staticfiles","children":[]}]}],"breadcrumbs":[{"docname":"ref/index","title":"Referência da API","url":"/pt-br/4.2/ref/"}],"prev":{"docname":"ref/applications","title":"Aplicações","url":"/pt-br/4.2/ref/applications/"},"next":{"docname":"ref/class-based-views/index","title":"API nativa de views baseadas em classes","url":"/pt-br/4.2/ref/class-based-views/"},"formats":{"html":"/pt-br/4.2/ref/checks/","markdown":"/pt-br/4.2/ref/checks.md","json":"/pt-br/4.2/ref/checks.json"},"source":"https://github.com/django/django/blob/stable/4.2.x/docs/ref/checks.txt","official":"https://docs.djangoproject.com/pt-br/4.2/ref/checks/","inVersions":["6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0","2.2","2.1","2.0","1.11","1.10","1.9"],"inLocales":["en","zh-hans","fr","ja","id","it","pt-br","ko","es","el","pl"]}