Os erros mais comuns do Moodle (e como resolver)

Os erros mais comuns do Moodle (e como resolver)

A boa notícia sobre "bugs" do Moodle: a maioria não é bug, é configuração. Conhecendo os suspeitos de sempre, você resolve rápido (ou sabe o que pedir a quem cuida do seu ambiente). Aqui estão os mais frequentes.

1. Cron parado: e-mails e notificações não saem

O Moodle depende do cron para tarefas em segundo plano. Se ele não roda de minuto em minuto, notificações não chegam e tarefas se acumulam. Fix: agendar o cron corretamente no servidor.

2. Permissões de arquivo / moodledata

Erros ao salvar ou fazer upload costumam ser permissão na pasta moodledata. Ajustar dono e permissões resolve.

3. "Database connection failed"

Erro de banco de dados: credenciais erradas, serviço do banco fora do ar ou sobrecarregado. Verifica-se a configuração e a saúde do servidor de banco.

4. Plugins incompatíveis após um upgrade

Atualizar o Moodle sem atualizar (ou remover) os plugins quebra páginas. Cada plugin precisa ser compatível com a versão. Sobre atualizar com segurança, veja o serviço de upgrade de versão.

5. Limites de PHP baixos

upload que falha, tela branca ao gerar relatório: normalmente limites de PHP (memory_limit, max_execution_time, upload_max_filesize) apertados demais. Ajustar no servidor resolve.

6. Cache "sujo"

Mudou tema ou configuração e algo ficou estranho? Purgar os caches resolve boa parte dos comportamentos inexplicáveis.

Quando chamar ajuda

Alguns erros (modais de AJAX, incompatibilidades sutis de tema/plugin) exigem quem conhece o Moodle por dentro. É o nosso dia a dia: se o seu ambiente está dando trabalho, fale com a gente e cuidamos da manutenção e do suporte.

Leia também: Moodle "Error connecting to the server" ou não abre: o que fazer.

Leia também: Esqueci a senha do Moodle: como recuperar (e por que o e-mail não chega).

Leia também: Moodle "Error reading from database": causas e como resolver.

Leia também: Moodle com erro 500: o que significa e como resolver.

Leia também: Cron do Moodle não roda: sintomas e como configurar.

Leia também: Moodle não envia e-mails: causas e como resolver.

Leia também: Moodle não faz login: causas e como resolver.

Perguntas frequentes

Por que o Moodle não envia e-mails?

Quase sempre porque o cron não está rodando com frequência. O Moodle depende do cron para enviar notificações e processar tarefas; agende-o para rodar a cada 1 minuto.

O que é o cron do Moodle?

É um processo agendado que executa tarefas em segundo plano (e-mails, backups, notificações, limpezas). Se não roda direito, tarefas se acumulam e a plataforma engasga.

Como limpar o cache do Moodle?

Em Administração do site, use a opção de purgar caches. Depois de mudanças em tema, plugins ou configuração, limpar o cache resolve muitos comportamentos estranhos.

Alejandro Argachá, especialista em Moodle

Escrito por Alejandro Argachá

Conhece o Moodle desde 2011 e, desde 2016, atua na parte técnica: servidor, código e segurança. Mais de 250 projetos entregues, boa parte para outras empresas que vendem Moodle. Resolve na prática problemas como este em plataformas de empresas e instituições brasileiras. Ver casos reais.