---
title: "Soluções de Problemas"
version: 1.10
locale: pt-br
source: https://docs.djangoproject.com/pt-br/1.10/faq/troubleshooting/
canonical: https://djangodocs.dev/pt-br/1.10/faq/troubleshooting/
---
# Soluções de Problemas

Essa página contém alguns conselhos sobre erros e problemas comumente encontrados durante o desenvolvimento de aplicações em Django.

## Problemas ao rodar o `django-admin`

### “comando não encontrado: django-admin”

O [django-admin](/pt-br/1.10/ref/django-admin/) deve estar no caminho do seu sistema caso tenha instalado o Django via: `python setup.py`. Caso ele não esteja no seu caminho você pode encontrá-lo em `site-packages/django/bin`, onde `site-packages` é um diretório dentro do seu projeto em Python. Considere criar um link simbólico [django-admin](/pt-br/1.10/ref/django-admin/) a partir de algum lugar em seu caminho, tal como `/usr/local/bin`.

Se o `django-admin` não funciona mas, `django-admin.py` sim, você provavelmente está usando uma versão antiga do Django que não coincide com a versão desta documentação.  `django-admin` é novo no Django 1.7.

### Permissões no Mac OS X

Se você está usando Mac OS X talvez você veja a mensagem: “permission denied” quando você estiver tentando executar `django-admin`. Isso ocorre porque, em sistemas parecidos com OS X baseados em Unix um arquivo precisa ser marcado como “executável” antes dele poder ser executado como um programa. Para fazer isso, abra o Terminal.app e navegue (usando o comando `cd`) até o diretório em que o [django-admin](/pt-br/1.10/ref/django-admin/) está instalado, então logo após execute o comando: `sudo chmod +x django-admin`.

## Variados

### Estou recebendo um `UnicodeDecodeError`. O que estou fazendo de errado?

Estas classes de erros acontecem quando um bytestring contendo sequências não-ASCII é transformado em uma sequência de caracteres Unicode e a codificação especificada está incorreta. A saída geralmente se parece com isso:

```
UnicodeDecodeError: 'ascii' codec can't decode byte 0x?? in position ?:
ordinal not in range(128)
```

A resolução depende principalmente do contexto, entretanto aqui estão as duas armadilhas comuns que produzem este erro:

- O locale padrão do sistema pode estar definido como ASCII, como o locale “C” nos sistemas baseados em UNIX (você pode checar com o comando `locale`). Se este é o caso, por favor, consulte a documentação do sistema para aprender como mudar para o locale: UTF-8.
- Você criou um raw bytestrings, o que é fácil de fazer em Python 2:

  ```
  my_string = 'café'
  ```

  Use o prefixo `u''` ou até melhor, adicione a linha `from __future__ import unicode_literals` no topo do arquivo para torná-lo compatível com Python 3.2, que não suporta o prefixo `u''`.

Recursos relacionados:

- [Unicode em Django](/pt-br/1.10/ref/unicode/)
- <https://wiki.python.org/moin/UnicodeDecodeError>