O framework de verificação do sistema.¶
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.
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..
Referência da API¶
CheckMessage
¶
-
class
CheckMessage
(level, msg, hint=None, obj=None, id=None)¶
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.
Os argumentos do Construtor são:
level
- A gravidade da mensagem. Use um dos valores pré-definidos:
DEBUG
,INFO
,WARNING
,ERROR
,CRITICAL
. Se o nível é maior ou igual aERROR`, 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. msg
- Uma string curta (menor que 80 caracetres) descrevendo o problema. A string não deve conter outras linhas.
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. 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. id
- String opcional. Um identificador único para esse problema. Identificadores devem seguir o formato padrão
applabel.X001
, ondeX
é uma das letras deCEWID
, 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.
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.
-
class
Debug
(msg, hint=None, obj=None, id=None)¶
-
class
Info
(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)¶
Tags embutidas¶
As verificações do sistema do Django estão organizadas usando as seguintes tags:
admin
: verifica qualquer declarações do “admin site”.- async_support: Verifica a configuração relacionada a assincronia.
caches
: Verifica configuração relacionada a cache.compatibility
: Indica potenciais problemas com atualizações da versão.database
: Verifica problemas de configuração relacionados ao banco de dados. As verificações do banco de dados não são executadas por padrão porque elas fazem mais do que a análise de código estático, como as verificações regulares. Elas só são executadas pelo comandomigrate
ou se você especificar os aliases de banco de dados configurados usando a opção--database
ao chamar o comandocheck
.files
: Verifica as configurações relacionadas a arquivos.models
: Verificações de definições de modelos, campos e gerenciadores.security
: verifica configurações relacionadas com segurança.signals
: verifica sobre declarações de “signals” e com o registro dos manipuladores.sites
: Verifica a configuração do :mod:django.contrib.sites.staticfiles
: Verifica a configuração dodjango.contrib.staticfiles
.templates
: verifica configuração relacionadas a templates.translation
: Verifica a configuração relacionada à tradução.urls
: verifica a configuração da URL.
Algumas verificações talvez sejam registradas com múltiplas tags.
Verificações do núcleo do sistema¶
Suporte assíncrono¶
As seguintes checagens verificarão seu setup para Asynchronous support:
- async.E001: Você não deve definir a variável de ambiente
DJANGO_ALLOW_ASYNC_UNSAFE
em produção. Isso desabilita a proteção de segurança assíncrona.
Retrocompatibilidade¶
Testes de compatibilidade notificam sobre problemas que podem ocorrer após atualizar o Django.
- 2_0.W001: Sua URL
<pattern>
tem umroute
que contém(?P<
, começa com um^
ou termina com um$
. Isso provavelmente foi um descuido ao migrar deurl()
parapath()
. - 4_0.E001: A partir do Django 4.0, os valores na configuração
CSRF_TRUSTED_ORIGINS
devem começar com um esquema (geralmentehttp://
ouhttps://
), mas foi encontrado<hostname>
.
Caches¶
As verificações seguintes averiguam se seu CACHES
está configurado corretamente:
- caches.E001: Você deve definir um cache
'default'
para a definição deCACHES
. - caches.W002: Sua configuração
<cache>
pode expor o seu cache ou levar à corrupção dos seus dados porque aLOCATION
<CACHES-LOCATION> coincide/está dentro/contém aMEDIA_ROOT
/STATIC_ROOT
/STATICFILES_DIRS
. - caches.W003: Your
<cache>
cacheLOCATION
is relative. Use an absolute path instead.
Banco de dados¶
MySQL e MariaDB¶
If you’re using MySQL or MariaDB, the following checks will be performed:
- mysql.E001: MySQL/MariaDB does not allow unique
CharField
s to have amax_length
> 255. This check was changed tomysql.W003
in Django 3.1 as the real maximum size depends on many factors. - mysql.W002: MySQL/MariaDB Strict Mode is not set for database connection
<alias>
. See also Setting sql_mode. - mysql.W003: MySQL/MariaDB may not allow unique
CharField
s to have amax_length
> 255.
Gerenciando arquivos¶
The following checks verify your setup for Managing files:
- files.E001: The
FILE_UPLOAD_TEMP_DIR
setting refers to the nonexistent directory<path>
.
Campos Modelos¶
- fields.E001: Nomes de campos não devem terminar com “underscore”.
- fields.E002: nome de campos não devem conter
"__"
. - fields.E003:
pk
é uma palavra reservada que não pode ser usada como nome de campo. - fields.E004:
choices
must be a mapping (e.g. a dictionary) or an iterable (e.g. a list or tuple). - fields.E005:
choices
must be a mapping of actual values to human readable names or an iterable containing(actual value, human readable name)
tuples. - fields.E006:
db_index
deve serNone
,True
ouFalse
. - fields.E007: Chaves-primárias não devem ter
null=True
. - fields.E008: All
validators
must be callable. - fields.E009:
max_length
is too small to fit the longest value inchoices
(<count>
characters). - fields.E010:
<field>
default should be a callable instead of an instance so that it’s not shared between all field instances. - fields.E011:
<database>
does not support default database values with expressions (db_default
). - fields.E012:
<expression>
cannot be used indb_default
. - fields.E100:
AutoField
s devem setar primary_key=True. - fields.E110:
BooleanField
s do not accept null values. This check appeared before support for null values was added in Django 2.1. - fields.E120:
CharField
s deve definir um atributomax_length
. - fields.E121:
max_length
deve ser um inteiro positivo. - fields.W122:
max_length
is ignored when used with<integer field type>
. - fields.E130:
DecimalField
s deve definir um atributodecimal_places
. - fields.E131:
decimal_places
deve ser um inteiro não negativo. - fields.E132:
DecimalField
s deve ter um atributomax_digits
. - fields.E133:
max_digits
must be a positive integer. - fields.E134:
max_digits
deve ser igual ou maior quedecimal_places
. - fields.E140:
FilePathField
s deve terallow_files
ouallow_folders
definidos como True. - fields.E150:
GenericIPAddressField
s cannot haveblank=True
ifnull=False
, as blank values are stored as nulls. - fields.E160: As opções
auto_now
,auto_now_add
, edefault
são mutualmente exclusivas. Somente uma destas opções deve estar presente. - fields.W161: Fornecido um valor fixo padrão.
- fields.W162:
<database>
does not support a database index on<field data type>
columns. - fields.W163:
<database>
does not support comments on columns (db_comment
). - fields.E170:
BinaryField
’sdefault
cannot be a string. Use bytes content instead. - fields.E180:
<database>
does not supportJSONField
s. - fields.E190:
<database>
does not support a database collation on<field_type>
s. - fields.E220:
<database>
does not supportGeneratedField
s. - fields.E221:
<database>
does not support non-persistedGeneratedField
s. - fields.E222:
<database>
does not support persistedGeneratedField
s. - fields.E223:
GeneratedField.output_field
has errors: … - fields.W224:
GeneratedField.output_field
has warnings: … - fields.E900:
IPAddressField
foi removido exceto para suportar migrações históricas. - fields.W900:
IPAddressField
está obsoleto. O suporte para este (exceto para histórico de migrações) será removido no Django 1.9. Esta verificação apareceu em Django 1.7 and 1.8. - fields.W901:
CommaSeparatedIntegerField
has been deprecated. Support for it (except in historical migrations) will be removed in Django 2.0. This check appeared in Django 1.10 and 1.11. - fields.E901:
CommaSeparatedIntegerField
is removed except for support in historical migrations. - fields.W902:
FloatRangeField
is deprecated and will be removed in Django 3.1. This check appeared in Django 2.2 and 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.W905:
django.contrib.postgres.fields.CICharField
is deprecated. Support for it (except in historical migrations) will be removed in Django 5.1. - fields.W906:
django.contrib.postgres.fields.CIEmailField
is deprecated. Support for it (except in historical migrations) will be removed in Django 5.1. - fields.W907:
django.contrib.postgres.fields.CITextField
is deprecated. Support for it (except in historical migrations) will be removed in Django 5.1.
Campos de Arquivo¶
- fields.E200:
unique
não é um argumento válido paraFileField
. Esta verificação foi removida no Django 1.11. - fields.E201:
primary_key
não é um argumento válido para umFileField
. - fields.E202:
FileField
’supload_to
argument must be a relative path, not an absolute path. - fields.E210: Não é possível usar
ImageField
porque o Pillow não está instalado.
Models¶
- models.E001:
<swappable>
não está no formatoapp_label.app_name
. - models.E002:
<SETTING>
referencia<model>
, o qual nao foi instalado, ou é abstrato. - models.E003: The model has two identical many-to-many relations through
the intermediate model
<app_label>.<model>
. - models.E004:
id
somente pode ser usado como nome de um campo se o campo também definirprimary_key=True
. - models.E005: O campo
<field name>
do modelo pai<model>
colide com o campo<field name>
do modelo pai<model>
. - models.E006: The field
<field name>
clashes with the field<field name>
from model<model>
. - models.E007: Campo
<field name>
tem o nome de coluna<column name>
que é usado por outro campo. - models.E008:
index_together
deve ser uma lista de tuplas. - models.E009: Todos os elementos
index_together
devem ser uma lista de tuplas. - models.E010:
unique_together
deve ser uma lista de tuplas. - models.E011: Todos os elementos de
unique_together
devem ser uma lista de tuplas. - models.E012:
constraints/indexes/index_together/unique_together
refers to the nonexistent field<field name>
. - models.E013:
constraints/indexes/index_together/unique_together
refers to aManyToManyField
<field name>
, butManyToManyField
s are not supported for that option. - models.E014:
ordering
deve ser uma tupla ou listat (mesmo que você queira ordernar por um único campo). - models.E015:
ordering
refers to the nonexistent field, related field, or lookup<field name>
. - models.E016:
constraints/indexes/index_together/unique_together
refers to field<field_name>
which is not local to model<model>
. - models.E017: O modelo proxy
<model>
cotém campos de modelo. - models.E018: Nome de coluna gerado automaticamente é muito longo para o campo
<field>
. O comprimento máximo é<maximum length>
para o banco de dados<alias>
. - models.E019: Nome de campo gerado automaticamente para o campo M2M
<M2M field>
é muito longo. O comprimento máximo é<maximum length>
para o banco de dados<alias>
. - models.E020: The
<model>.check()
método da classe está neste momento sobrescrito. - models.E021:
ordering
eorder_with_respect_to
não podem ser usados juntos. - models.E022:
<function>
contains a lazy reference to<app label>.<model>
, but app<app label>
isn’t installed or doesn’t provide model<model>
. - models.E023: The model name
<model>
cannot start or end with an underscore as it collides with the query lookup syntax. - models.E024: The model name
<model>
cannot contain double underscores as it collides with the query lookup syntax. - models.E025: The property
<property name>
clashes with a related field accessor. - models.E026: The model cannot have more than one field with
primary_key=True
. - models.W027:
<database>
does not support check constraints. - models.E028:
db_table
<db_table>
is used by multiple models:<model list>
. - models.E029: index name
<index>
is not unique for model<model>
. - models.E030: index name
<index>
is not unique among models:<model list>
. - models.E031: constraint name
<constraint>
is not unique for model<model>
. - models.E032: constraint name
<constraint>
is not unique among models:<model list>
. - models.E033: The index name
<index>
cannot start with an underscore or a number. - models.E034: The index name
<index>
cannot be longer than<max_length>
characters. - models.W035:
db_table
<db_table>
is used by multiple models:<model list>
. - models.W036:
<database>
does not support unique constraints with conditions. - models.W037:
<database>
does not support indexes with conditions. - models.W038:
<database>
does not support deferrable unique constraints. - models.W039:
<database>
does not support unique constraints with non-key columns. - models.W040:
<database>
does not support indexes with non-key columns. - models.E041:
constraints
refers to the joined field<field name>
. - models.W042: Auto-created primary key used when not defining a primary
key type, by default
django.db.models.AutoField
. - models.W043:
<database>
does not support indexes on expressions. - models.W044:
<database>
does not support unique constraints on expressions. - models.W045: Check constraint
<constraint>
containsRawSQL()
expression and won’t be validated during the modelfull_clean()
. - models.W046:
<database>
does not support comments on tables (db_table_comment
). - models.W047:
<database>
does not support unique constraints with nulls distinct.
Segurança¶
The security checks do not make your site secure. They do not audit code, do intrusion detection, or do anything particularly complex. Rather, they help perform an automated, low-hanging-fruit checklist, that can help you to improve your site’s security.
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.
As seguintes verificações são executadas se você usa a opção check --deploy
:
- security.W001: You do not have
django.middleware.security.SecurityMiddleware
in yourMIDDLEWARE
so theSECURE_HSTS_SECONDS
,SECURE_CONTENT_TYPE_NOSNIFF
,SECURE_REFERRER_POLICY
,SECURE_CROSS_ORIGIN_OPENER_POLICY
, andSECURE_SSL_REDIRECT
settings will have no effect. - security.W002: You do not have
django.middleware.clickjacking.XFrameOptionsMiddleware
in yourMIDDLEWARE
, so your pages will not be served with an'x-frame-options'
header. Unless there is a good reason for your site to be served in a frame, you should consider enabling this header to help prevent clickjacking attacks. - security.W003: You don’t appear to be using Django’s built-in cross-site
request forgery protection via the middleware
(
django.middleware.csrf.CsrfViewMiddleware
is not in yourMIDDLEWARE
). Enabling the middleware is the safest approach to ensure you don’t leave any holes. - security.W004: Você não definiu um valor para a definição de
SECURE_HSTS_SECONDS
. Se todo o seu site é servido via SSL, talvez queira considerar definir o valor e habilitar HTTP Strict Transport Security. Tenha certeza de ler a documentação primeiro; habilitando HSTS sem cuidados você pode causar problema sérios e irreversíveis. - security.W005: Você não definiu a definição de
SECURE_HSTS_INCLUDE_SUBDOMAINS
paraTrue
. Sem isso, seu site está pontencialmente vulnerável a ataques através de uma conexão insegura para um subdomínio. Somente definica comoTrue
se você está certo de que todos os subdomínios do seu domínio devem ser servidos exclusivamente via SSL. - security.W006: Your
SECURE_CONTENT_TYPE_NOSNIFF
setting is not set toTrue
, so your pages will not be served with an'X-Content-Type-Options: nosniff'
header. You should consider enabling this header to prevent the browser from identifying content types incorrectly. - security.W007: Your
SECURE_BROWSER_XSS_FILTER
setting is not set toTrue
, 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 theX-XSS-Protection
header is no longer honored by modern browsers. - security.W008: Sua definição para
SECURE_SSL_REDIRECT
não éTrue
. A menos que seu site deva estar disponível tanto para conexões SSL quanto para não SSL, você talvez queira definir este comoTrue
ou configurar o balanceador de carga ou o servidor de proxy reverso para redirecionar todas as conexões para HTTPS. - security.W009: Your
SECRET_KEY
has less than 50 characters, less than 5 unique characters, or it’s prefixed with'django-insecure-'
indicating that it was generated automatically by Django. Please generate a long and random value, otherwise many of Django’s security-critical features will be vulnerable to attack. - security.W010: Você tem
django.contrib.sessions
no seuINSTALLED_APPS
mas não definiuSESSION_COOKIE_SECURE
comoTrue
. Usando uma “cookie” de sessão “somente-segura” é mais difícil para um “sniffer” de tráfego de rede capturar sessões do usuário. - security.W011: You have
django.contrib.sessions.middleware.SessionMiddleware
in yourMIDDLEWARE
, but you have not setSESSION_COOKIE_SECURE
toTrue
. Using a secure-only session cookie makes it more difficult for network traffic sniffers to hijack user sessions. - security.W012:
SESSION_COOKIE_SECURE
não éTrue
. Usando uma “cookie” de sessão como “somente-segura” é mais difícil para um “sniffer” de tráfego de rede capturar sessões do usuário. - security.W013: Você
django.contrib.sessions
no seuINSTALLED_APPS
, mas não definiuSESSION_COOKIE_HTTPONLY
comoTrue
. Usando uma “cookie” de sessãoHttpOnly
faz com que seja mais difícil um ataque de script extra-site capturar sessões de usuários. - security.W014: You have
django.contrib.sessions.middleware.SessionMiddleware
in yourMIDDLEWARE
, but you have not setSESSION_COOKIE_HTTPONLY
toTrue
. Using anHttpOnly
session cookie makes it more difficult for cross-site scripting attacks to hijack user sessions. - security.W015:
SESSION_COOKIE_HTTPONLY
não está definido comoTrue
. Usando uma cookie de sessão comoHttpOnly
torna mais difícil um ataque de script extra-site capturar sessões de usuários. - security.W016:
CSRF_COOKIE_SECURE
não está comoTrue
. Usando a “secure-only” para a “cookie” CSRF torna mais difícil para um “sniffer” de tráfego de rede roubar o token CSRF. - security.W017:
CSRF_COOKIE_HTTPONLY
is not set toTrue
. Using anHttpOnly
CSRF cookie makes it more difficult for cross-site scripting attacks to steal the CSRF token. This check is removed in Django 1.11 as theCSRF_COOKIE_HTTPONLY
setting offers no practical benefit. - security.W018: Você não deve definir
DEBUG
comoTrue
em produção. - security.W019: You have
django.middleware.clickjacking.XFrameOptionsMiddleware
in yourMIDDLEWARE
, butX_FRAME_OPTIONS
is not set to'DENY'
. Unless there is a good reason for your site to serve other parts of itself in a frame, you should change it to'DENY'
. - security.W020:
ALLOWED_HOSTS
não deve estar vazio durante a implantação. - security.W021: You have not set the
SECURE_HSTS_PRELOAD
setting toTrue
. Without this, your site cannot be submitted to the browser preload list. - security.W022: You have not set the
SECURE_REFERRER_POLICY
setting. Without this, your site will not send a Referrer-Policy header. You should consider enabling this header to protect user privacy. - security.E023: You have set the
SECURE_REFERRER_POLICY
setting to an invalid value. - security.E024: You have set the
SECURE_CROSS_ORIGIN_OPENER_POLICY
setting to an invalid value. - security.W025: Your
SECRET_KEY_FALLBACKS[n]
has less than 50 characters, less than 5 unique characters, or it’s prefixed with'django-insecure-'
indicating that it was generated automatically by Django. Please generate a long and random value, otherwise many of Django’s security-critical features will be vulnerable to attack.
The following checks verify that your security-related settings are correctly configured:
- security.E100:
DEFAULT_HASHING_ALGORITHM
must be'sha1'
or'sha256'
. This check appeared in Django 3.1 and 3.2. - security.E101: The CSRF failure view
'path.to.view'
does not take the correct number of arguments. - security.E102: The CSRF failure view
'path.to.view'
could not be imported.
Signals¶
- signals.E001:
<handler>
was connected to the<signal>
signal with a lazy reference to the sender<app label>.<model>
, but app<app label>
isn’t installed or doesn’t provide model<model>
.
Templates¶
As verificações seguintes averiguam se sua definição de TEMPLATES
está corretamente configurada.
- templates.E001: Você tem
'APP_DIRS': True
no seuTEMPLATES
mas também especifica o'loaders'
nasOPTIONS
. Ou remova oAPP_DIRS
ou a opção'loaders'
. - templates.E002:
string_if_invalid
inTEMPLATES
OPTIONS
must be a string but got:{value}
({type}
). - templates.E003:
<name>
is used for multiple template tag modules:<module list>
. This check was changed totemplates.W003
in Django 4.1.2. - templates.W003:
<name>
is used for multiple template tag modules:<module list>
.
Translation¶
The following checks are performed on your translation configuration:
- translation.E001: You have provided an invalid value for the
LANGUAGE_CODE
setting:<value>
. - translation.E002: You have provided an invalid language code in the
LANGUAGES
setting:<value>
. - translation.E003: You have provided an invalid language code in the
LANGUAGES_BIDI
setting:<value>
. - translation.E004: You have provided a value for the
LANGUAGE_CODE
setting that is not in theLANGUAGES
setting.
URLs¶
As verificações seguintes são realizadas na sua configuração de URL:
- urls.W001: Your URL pattern
<pattern>
usesinclude()
with aroute
ending with a$
. Remove the dollar from theroute
to avoid problems including URLs. - urls.W002: Your URL pattern
<pattern>
has aroute
beginning with a/
. Remove this slash as it is unnecessary. If this pattern is targeted in aninclude()
, ensure theinclude()
pattern has a trailing/
. - urls.W003: Seu formato padrão de
<pattern>
tem umname
incluindo um:
. Remova os dois-pontos para evitar referências anbíguas de domínios baseados em nomes. - urls.E004: Your URL pattern
<pattern>
is invalid. Ensure thaturlpatterns
is a list ofpath()
and/orre_path()
instances. - urls.W005: URL namespace
<namespace>
isn’t unique. You may not be able to reverse all URLs in this namespace. - urls.E006: The
MEDIA_URL
/STATIC_URL
setting must end with a slash. - urls.E007: The custom
handlerXXX
view'path.to.view'
does not take the correct number of arguments (…). - urls.E008: The custom
handlerXXX
view'path.to.view'
could not be imported. - urls.E009: Your URL pattern
<pattern>
has an invalid view, pass<view>.as_view()
instead of<view>
. - urls.W010: Your URL pattern
<pattern>
has an unmatched<angle bracket>
.
contrib
app checks¶
admin
¶
Verificações do Admin são todas realizadas como parte da etiqueta admin
.
As seguintes verificações sào realizadas em qualquer ModelAdmin
(ou subclasse) que está registrada com o site Admin:
- admin.E001: O valor de
raw_id_fields
deve ser uma lista de tuplas. - admin.E002: The value of
raw_id_fields[n]
refers to<field name>
, which is not a field of<model>
. - admin.E003: O valor de
raw_id_fields[n]
deve ser uma chave estrangeira ou m campo muitos-para-muitos. - admin.E004: O valor do
fields
deve ser uma lista de tuplas. - admin.E005: Ambos
fieldsets
efields
são especificados. - admin.E006: O valor do
fields
contém campo(s) duplicados. - admin.E007: O valor do
fieldsets
deve ser uma lista de tuplas. - admin.E008: O valor do
fieldsets[n]
deve ser uma lista de tuplas. - admin.E009: O valor do
fieldsets[n]
deve ter o comprimento igual a 2. - admin.E010: O valor do
fieldsets[n][1]
deve ser um dicionário. - admin.E011: O valor do
fieldsets[n][1]
deve conter a chavefields
. - admin.E012: Existem campo(s) ducplicados em
fieldsets[n][1]
. - admin.E013: The value of
fields[n]/filter_horizontal[n]/filter_vertical[n]/fieldsets[n][m]
cannot include theManyToManyField
<field name>
, because that field manually specifies a relationship model. - admin.E014: O valor do
exclude
deve ser uma lista de tuplas. - admin.E015: O valor do
exclude
contém campos duplicado(s). - admin.E016: O valor do
form
deve herdar deBaseModelForm
. - admin.E017: O valor do
filter_vertical
deve ser uma lista de tuplas. - admin.E018: O valor de
filter_horizontal
deve ser uma lista de tuplas. - admin.E019: The value of
filter_vertical[n]/filter_horizontal[n]
refers to<field name>
, which is not a field of<model>
. - admin.E020: The value of
filter_vertical[n]/filter_horizontal[n]
must be a many-to-many field. - admin.E021: O valor de
radio_fields
deve ser um dicionário. - admin.E022: The value of
radio_fields
refers to<field name>
, which is not a field of<model>
. - admin.E023: The value of
radio_fields
refers to<field name>
, which is not an instance ofForeignKey
, and does not have achoices
definition. - admin.E024: O valor de
radio_fields[<field name>]
deve seradmin.HORIZONTAL
ouadmin.VERTICAL
. - admin.E025: O valor de
view_on_site
deve ser um “callable” ou um booleano. - admin.E026: O valor de
prepopulated_fields
deve ser um dicionário. - admin.E027: The value of
prepopulated_fields
refers to<field name>
, which is not a field of<model>
. - admin.E028: The value of
prepopulated_fields
refers to<field name>
, which must not be aDateTimeField
, aForeignKey
, aOneToOneField
, or aManyToManyField
field. - admin.E029: O valor de
prepopulated_fields[<field name>]
deve ser uma lista de tuplas. - admin.E030: The value of
prepopulated_fields
refers to<field name>
, which is not a field of<model>
. - admin.E031: O valor de
ordering
deve ser uma lista de tuplas. - admin.E032: O valor de
ordering
tem o operador para ordem randômica?
, mas contém outros campos também. - admin.E033: The value of
ordering
refers to<field name>
, which is not a field of<model>
. - admin.E034: O valor de
readonly_fields
deve ser uma lista de tuplas. - admin.E035: The value of
readonly_fields[n]
refers to<field_name>
, which is not a callable, an attribute of<ModelAdmin class>
, or an attribute of<model>
. - admin.E036: The value of
autocomplete_fields
must be a list or tuple. - admin.E037: The value of
autocomplete_fields[n]
refers to<field name>
, which is not a field of<model>
. - admin.E038: The value of
autocomplete_fields[n]
must be a foreign key or a many-to-many field. - admin.E039: An admin for model
<model>
has to be registered to be referenced by<modeladmin>.autocomplete_fields
. - admin.E040:
<modeladmin>
must definesearch_fields
, because it’s referenced by<other_modeladmin>.autocomplete_fields
.
ModelAdmin
¶
A verificações seguintes são realizadas para qualquer ModelAdmin
que é registrada com site Admin:
- admin.E101: O valor de
save_as
deve ser um booleano. - admin.E102: O valor de
save_on_top
deve ser um booleano. - admin.E103: O valor de
inlines
deve ser uma lista de tuplas. - admin.E104:
<InlineModelAdmin class>
must inherit fromInlineModelAdmin
. - admin.E105:
<InlineModelAdmin class>
deve ter um atributomodel
. - admin.E106: O valor de
<InlineModelAdmin class>.model
deve ser umModel
. - admin.E107: O valor de
list_display
deve ser uma lista de tuplas. - 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>
. - admin.E109: The value of
list_display[n]
must not be a many-to-many field or a reverse foreign key. - admin.E110: O valor de
list_display_links
deve ser uma lista, uma tupla, ouNone
. - admin.E111: O valor de
list_display_links[n]
referencia a<label>
, o qual não é definido nalist_display
. - admin.E112: O valor de
list_filter
deve ser uma lista de tuplas. - admin.E113: O valor de
list_filter[n]
deve herdar deListFilter
. - admin.E114: O valor de
list_filter[n]
não deve herdar deFieldListFilter
. - admin.E115: O valor de
list_filter[n][1]
deve herdar deFieldListFilter
. - admin.E116: O valor de
list_filter[n]
refere a<label>
, o qual não refere a um campo. - admin.E117: O valor de
list_select_related
deve ser um booleano, tuplas ou lista. - admin.E118: O valor de
list_per_page
deve ser um inteiro. - admin.E119: O valor de
list_max_show_all
deve ser um inteiro. - admin.E120: O valor de
list_editable
deve ser uma lista de tuplas. - admin.E121: The value of
list_editable[n]
refers to<label>
, which is not a field of<model>
. - admin.E122: O valor de
list_editable[n]
refere a<label>
, o qual não está contido emlist_display
. - admin.E123: O valor de
list_editable[n]
não pode estar em amboslist_editable
elist_display_links
. - admin.E124: O valor de
list_editable[n]
refere ao primeiro campo emlist_display
(<label>
), o qual não pode ser usado a menos quelist_display_links
seja definido. - admin.E125: O valor de
list_editable[n]
refere a<field name>
, o qual não é editável através do admin. - admin.E126: O valor de
search_fields
deve ser uma lista de tuplas. - admin.E127: The value of
date_hierarchy
refers to<field name>
, which does not refer to a Field. - admin.E128: O valor de
date_hierarchy
deve ser umDateField
ouDateTimeField
. - admin.E129:
<modeladmin>
must define ahas_<foo>_permission()
method for the<action>
action. - admin.E130:
__name__
attributes of actions defined in<modeladmin>
must be unique. Name<name>
is not unique.
InlineModelAdmin
¶
As verificações seguintes são realizadas em qualquer InlineModelAdmin
que esteja registrado como uma “inline” na ModelAdmin
.
- admin.E201: Não pode excluir o campo
<field name>
, porque ele é a chave-estrangeira para o modelo<app_label>.<model>
. - admin.E202:
<model>
has noForeignKey
to<parent model>
./<model>
has more than oneForeignKey
to<parent model>
. You must specify afk_name
attribute. - admin.E203: O valor de
extra
deve ser um inteiro. - admin.E204: O valor de
max_num
deve ser um inteiro. - admin.E205: O valor de
min_num
deve ser um inteiro. - admin.E206: O valor de
formset
deve herdar deBaseModelFormSet
.
GenericInlineModelAdmin
¶
As seguintes verificações são realizadas sobre qualquer GenericInlineModelAdmin
que esteja registrado como “inline” no ModelAdmin
.
- admin.E301:
'ct_field'
referencia a<label>
, o qual não é um campo no<model>
. - admin.E302:
'ct_fk_field'
referencia<label>
, o qual não é um campo no<model>
. - admin.E303:
<model>
não temGenericForeignKey
. - admin.E304:
<model>
não temGenericForeignKey
usando o campo de tipo de conteúdo<field name>
e um campo de ID do objeto<field name>
.
AdminSite
¶
As seguintes verificações são realizadas na AdminSite
: padrão
- admin.E401:
django.contrib.contenttypes
must be inINSTALLED_APPS
in order to use the admin application. - admin.E402:
django.contrib.auth.context_processors.auth
must be enabled inDjangoTemplates
(TEMPLATES
) if using the default auth backend in order to use the admin application. - admin.E403: A
django.template.backends.django.DjangoTemplates
instance must be configured inTEMPLATES
in order to use the admin application. - admin.E404:
django.contrib.messages.context_processors.messages
must be enabled inDjangoTemplates
(TEMPLATES
) in order to use the admin application. - admin.E405:
django.contrib.auth
must be inINSTALLED_APPS
in order to use the admin application. - admin.E406:
django.contrib.messages
must be inINSTALLED_APPS
in order to use the admin application. - admin.E408:
django.contrib.auth.middleware.AuthenticationMiddleware
must be inMIDDLEWARE
in order to use the admin application. - admin.E409:
django.contrib.messages.middleware.MessageMiddleware
must be inMIDDLEWARE
in order to use the admin application. - admin.E410:
django.contrib.sessions.middleware.SessionMiddleware
must be inMIDDLEWARE
in order to use the admin application. - admin.W411:
django.template.context_processors.request
must be enabled inDjangoTemplates
(TEMPLATES
) in order to use the admin navigation sidebar.
auth
¶
- auth.E001:
REQUIRED_FIELDS
deve ser uma lista de tuplas. - auth.E002: O campo definido como
USERNAME_FIELD
para um modelo de usuário personalizado não deve ser incluído noREQUIRED_FIELDS
. - auth.E003:
<field>
deve ser único porque ele está definido comoUSERNAME_FIELD
. - auth.W004:
<field>
é definido como oUSERNAME_FIELD
, mas não é único. - auth.E005: The permission codenamed
<codename>
clashes with a builtin permission for model<model>
. - auth.E006: The permission codenamed
<codename>
is duplicated for model<model>
. - auth.E007: The
verbose_name
of model<model>
must be at most 244 characters for its builtin permission names to be at most 255 characters. - auth.E008: The permission named
<name>
of model<model>
is longer than 255 characters. - auth.C009:
<User model>.is_anonymous
must be an attribute or property rather than a method. Ignoring this is a security issue as anonymous users will be treated as authenticated! - auth.C010:
<User model>.is_authenticated
must be an attribute or property rather than a method. Ignoring this is a security issue as anonymous users will be treated as authenticated! - auth.E011: The name of model
<model>
must be at most 93 characters for its builtin permission names to be at most 100 characters. - auth.E012: The permission codenamed
<codename>
of model<model>
is longer than 100 characters.
contenttypes
¶
As verificação seguintes são realizadas quando um modelo contém um GenericForeignKey
ou GenericRelation
:
- contenttypes.E001: The
GenericForeignKey
object ID references the nonexistent field<field>
. - contenttypes.E002: The
GenericForeignKey
content type references the nonexistent field<field>
. - contenttypes.E003:
<field>
não é umaForeignKey
. - contenttypes.E004:
<field>
não é umaForeignKey
paracontenttypes.ContentType
. - contenttypes.E005: Model names must be at most 100 characters.
postgres
¶
The following checks are performed on django.contrib.postgres
model
fields:
- postgres.E001: Base field for array has errors: …
- postgres.E002: Base field for array cannot be a related field.
- postgres.E003:
<field>
default should be a callable instead of an instance so that it’s not shared between all field instances. This check was changed tofields.E010
in Django 3.1. - postgres.W004: Base field for array has warnings: …
sites
¶
As verificações seguintes são realizadas em qualquer modelo usando uma CurrentSiteManager
:
- sites.E001:
CurrentSiteManager
não pode achar um campo chamado<field name>
. - sites.E002:
CurrentSiteManager
cannot use<field>
as it is not a foreign key or a many-to-many field.
The following checks verify that django.contrib.sites
is correctly
configured:
- sites.E101: The
SITE_ID
setting must be an integer.
staticfiles
¶
The following checks verify that django.contrib.staticfiles
is correctly
configured:
- staticfiles.E001: The
STATICFILES_DIRS
setting is not a tuple or list. - staticfiles.E002: The
STATICFILES_DIRS
setting should not contain theSTATIC_ROOT
setting. - staticfiles.E003: The prefix
<prefix>
in theSTATICFILES_DIRS
setting must not end with a slash. - staticfiles.W004: The directory
<directory>
in theSTATICFILES_DIRS
does not exist. - staticfiles.E005: The
STORAGES
setting must define astaticfiles
storage.