# Como corrigir alunos sem acesso ao login no Tutor LMS

Quando o aluno do Tutor LMS não consegue logar, ele e jogado para uma tela de login que recarrega sem entrar, cai em página 404 ou e redirecionado para o wp-admin sem ver os cursos. A causa mais comum e a página Dashboard do Tutor ausente ou não atribuida, seguida de um plugin de cache ou segurança bloqueando o POST de login.

## O que é o erro de login do aluno no Tutor LMS?

O Tutor LMS usa páginas proprias para login, cadastro e área do aluno (Dashboard e Student Registration). O acesso do aluno não passa pelo wp-login.php padrão: ele entra pelo formulário de login do Tutor e e levado ao Dashboard, onde ve seus cursos matriculados. Quando a página Dashboard e excluida, fica sem ser atribuida nas configurações ou o fluxo de login e interceptado por outro plugin, o aluno autentica mas não chega a área logada.

## Como identificar

- O aluno preenche o login do Tutor LMS, a página recarrega e volta para o mesmo formulário sem entrar.
- Após logar, o aluno cai numa página com a mensagem "Página não encontrada" (404) em vez do painel de cursos.
- O aluno e redirecionado para o wp-admin (ou recebe "Você não tem permissão para acessar esta página") logo após o login.
- O link "Dashboard" ou "Meus Cursos" leva a uma página em branco ou ao inicio do site.
- Na página Tutor LMS -> Tools -> Tutor Pages, a página Dashboard ou Student Registration aparece com status faltando.

**Antes de começar:** Antes de regenerar as páginas ou salvar permalinks num site em producao, faca backup do banco de dados: a regeneracao cria novas páginas e, se a Dashboard antiga tinha conteúdo ou widgets customizados, você vai precisar reaplica-los na página recriada.

## Como prevenir

- Nunca exclua manualmente as páginas Dashboard, Student Registration e Courses criadas pelo Tutor LMS; para esconde-las do menu, use a configuração de visibilidade, não a lixeira.
- Mantenha as páginas de login e dashboard do Tutor LMS sempre na lista de exclusão de cache do plugin de performance.
- Após migrar o site ou trocar de tema, salve os permalinks e rode Re-Generate Tutor Pages para revalidar as páginas obrigatorias.
- Ao ativar verificacao de e-mail ou 2FA no Authentication do Tutor LMS Pro, teste o fluxo completo de cadastro com uma conta de aluno real antes de liberar para a turma.

Erros relacionados

- [Como corrigir o acesso de alunos bloqueado pelo All in One Security no Tutor LMS](https://full.services/wp-fixer/corrigir-acesso-alunos-aios-tutor-lms/)
- [Como corrigir o Social Login que não funciona no Tutor LMS](https://full.services/wp-fixer/corrigir-social-login-tutor-lms/)
- [Como corrigir o erro de matricula no Tutor LMS quando o aluno não consegue comprar](https://full.services/wp-fixer/corrigir-enrollment-tutor-lms/)

## Causa

- Página Dashboard do Tutor LMS excluida ou não atribuida em Tutor LMS -> Tools -> Tutor Pages, deixando o aluno sem destino após o login.
- Plugin de cache servindo uma versão estática da página de login (com nonce expirado), fazendo o POST de login do Tutor LMS falhar silenciosamente.
- Plugin de segurança (firewall ou limite de tentativas) bloqueando o admin-ajax.php usado pelo login do Tutor LMS ou disparando reCAPTCHA que não carrega.
- Recurso de Authentication do Tutor LMS Pro ativo (verificacao de e-mail ou 2FA por OTP) exigindo uma etapa extra que o aluno não concluiu.
- Cadastro de aluno desativado em WordPress -> Configurações -> Geral (Qualquer pessoa pode se registrar desmarcado), impedindo a criação da conta do aluno.
- Permalinks corrompidos após migração ou troca de tema, quebrando a URL da página Dashboard e Student Registration do Tutor LMS.

## Como resolver

1. Regenere as páginas obrigatorias do Tutor LMS: no painel, abra a ferramenta de páginas do Tutor e clique para recriar as páginas que estiverem faltando. A ferramenta so cria as ausentes, não sobrescreve as existentes, entao e seguro rodar.

```
WP Admin -> Tutor LMS -> Tools -> Tutor Pages
Clique em "Re-Generate Tutor Pages"
```

2. Confirme a página Dashboard atribuida: verifique se a página Dashboard (e a Student Registration) esta de fato selecionada nas configurações do Tutor. Se estiver vazia, atribua a página recriada e salve.

```
WP Admin -> Tutor LMS -> Settings -> General -> Dashboard Page
```

3. Salve os permalinks: depois de recriar as páginas, force o WordPress a reconstruir as regras de reescrita para que a URL do Dashboard volte a resolver. Basta abrir os permalinks e salvar sem mudar nada.

```
WP Admin -> Configurações -> Links Permanentes -> Salvar alterações
```

4. Exclua a página de login do cache: se houver plugin de cache, não guarde em cache as páginas de login e dashboard do Tutor LMS. Cache nessas páginas serve nonce expirado e quebra o POST de login.

```
No plugin de cache, adicione as URLs do Dashboard e do login as exclusoes (Never Cache)
Limpe todo o cache após salvar
```

5. Teste com plugins de segurança desligados: desative temporariamente o firewall, o limitador de tentativas de login e qualquer reCAPTCHA. Se o aluno entrar, libere o admin-ajax.php e a página de login na allowlist do plugin de segurança e reative.

```
Desative o plugin de segurança e teste o login do aluno
Allowlist: /wp-admin/admin-ajax.php e a URL da página de login do Tutor
```


## Código

```php
// functions.php do tema filho ou mu-plugin
// Diagnostico: imprime os IDs das paginas obrigatorias do Tutor LMS
// e avisa se a pagina Dashboard nao existe mais (causa nº1 do login quebrado).
add_action( 'admin_notices', function () {
    if ( ! current_user_can( 'manage_options' ) || ! function_exists( 'tutor_utils' ) ) {
        return;
    }
    $dashboard_id = (int) tutor_utils()->get_option( 'tutor_dashboard_page_id' );
    $page         = $dashboard_id ? get_post( $dashboard_id ) : null;

    if ( ! $page || 'trash' === $page->post_status || 'page' !== $page->post_type ) {
        echo '<div class="notice notice-error"><p><strong>Tutor LMS:</strong> ';
        echo 'a pagina Dashboard (ID ' . esc_html( $dashboard_id ) . ') esta ausente ';
        echo 'ou na lixeira. Rode Tutor LMS -> Tools -> Tutor Pages -> Re-Generate.';
        echo '</p></div>';
    }
} );
```

## Perguntas frequentes

### Por que o aluno loga mas cai numa página 404 no Tutor LMS?

Porque a página Dashboard que recebe o aluno depois do login foi excluida ou não esta atribuida. Sem ela, o Tutor LMS não tem para onde mandar o usuário logado e a URL retorna 404. Rode Re-Generate Tutor Pages e confirme a Dashboard Page nas configurações.

### O plugin de cache pode impedir o aluno de logar no Tutor LMS?

Sim. Se a página de login do Tutor for cacheada, o navegador recebe um nonce de segurança já expirado e o envio do formulário falha sem mensagem clara, recarregando o login. Adicione as páginas de login e dashboard as exclusoes de cache e limpe o cache.

### Como regenero as páginas obrigatorias do Tutor LMS?

Va em WP Admin -> Tutor LMS -> Tools -> Tutor Pages e clique em Re-Generate Tutor Pages. A ferramenta recria apenas as páginas que estão faltando (Dashboard, Student Registration, Courses) e não sobrescreve as que já existem, entao e seguro rodar em producao.

### O aluno e jogado para o wp-admin depois de logar. Por que?

Isso acontece quando o redirecionamento pos-login do Tutor LMS não encontra a página Dashboard, ou quando um plugin de segurança forca o redirect para o admin. Como o aluno tem papel de assinante, ele ve apenas o perfil e parece sem permissão. Reatribua a Dashboard Page e libere o login na segurança.

### Desativei a verificacao de e-mail e o aluno ainda não entra. E so isso?

Não necessariamente. A verificacao de e-mail e o 2FA do Authentication Pro são apenas uma das causas. Se já desligou e o problema persiste, o foco passa a ser a página Dashboard ausente, o cache na página de login ou o firewall bloqueando o admin-ajax.php usado pelo login.

### Preciso reinstalar o Tutor LMS para corrigir o login?

Quase nunca. Antes disso, regenere as páginas, confirme a Dashboard Page, salve os permalinks, exclua o login do cache e teste sem o plugin de segurança. Reinstalar não recria as páginas atribuidas e ainda apaga configurações, entao e o último recurso, sempre com backup.

### O cadastro de novos alunos parou de funcionar também. Tem relacao?

Tem. A página Student Registration faz parte do mesmo conjunto de páginas obrigatorias do Tutor LMS. Se ela sumiu, o cadastro quebra junto com o login. Verifique também se em Configurações -> Geral a opção de qualquer pessoa se registrar esta marcada, pois o Tutor depende dela para criar a conta do aluno.

### Depois de migrar o site, ninguem mais consegue acessar a área do aluno. O que fazer?

Migração costuma quebrar os permalinks e as URLs das páginas do Tutor LMS. Salve os permalinks em Configurações -> Links Permanentes, rode Re-Generate Tutor Pages e confirme as páginas atribuidas. Isso revalida as URLs de Dashboard e login sem precisar recriar os cursos.

**Fonte:** [Tutor LMS — Re-generate Required Pages](https://docs.themeum.com/tutor-lms/tutorials/tutor-lms-re-generate-required-pages/)