UpdraftPlus erro Dropbox: causas e como corrigir

Tipo Migracao & Backup

Nome do erro Erro de Dropbox no UpdraftPlus EN: UpdraftPlus Dropbox connection error

Severidade Grave

Descrição O UpdraftPlus erro Dropbox aparece quando o plugin gera o backup local mas falha ao enviar os arquivos para a conta Dropbox. As causas reais são o token de acesso revogado ou expirado, a conta nunca ter concluido a reautorizacao ou o servidor bloquear a conexão com api.dropboxapi.com.

O que é o erro de Dropbox no UpdraftPlus?

O UpdraftPlus separa o backup em duas etapas: primeiro gera os arquivos zip e o dump do banco na pasta wp-content/updraft, depois envia essas copias para o destino remoto. Quando o destino e o Dropbox, a segunda etapa depende de um token de acesso valido emitido pelo fluxo de autorizacao do Dropbox e da pasta Apps/UpdraftPlus.Com, criada automaticamente na sua conta.

Se esse token foi revogado, se a autorizacao nunca foi concluida ou se o servidor não consegue alcancar a API do Dropbox, o backup local fica pronto mas o envio nunca completa. O painel do UpdraftPlus registra a falha no log da execução, e os arquivos esperados na pasta Apps/UpdraftPlus.Com nunca aparecem.

Como identificar

O log do UpdraftPlus mostra a linha “Dropbox error: expired_access_token” ou “Dropbox returned an error: invalid_access_token” ao tentar enviar o arquivo.
O log registra “The Dropbox authentication failed” e o backup conclui localmente em wp-content/updraft, mas a coluna do Dropbox na lista de backups fica vazia.
Após clicar em autorizar, o navegador volta para o painel com a mensagem “You have not yet authenticated with Dropbox”, indicando que a autorizacao nunca foi concluida.
A pasta Apps/UpdraftPlus.Com existe na conta Dropbox mas não recebe arquivos novos, e o log aponta timeout ao conectar em api.dropboxapi.com.

Como prevenir

Rode um backup de teste manual para o Dropbox logo após qualquer mudanca de senha do Dropbox ou reautorizacao, para confirmar que o token continua valido.
Defina retencao de backups no UpdraftPlus e revise a pasta Apps/UpdraftPlus.Com periodicamente, apagando copias antigas para não lotar a conta.
Mantenha o OpenSSL e os certificados raiz do servidor atualizados e garanta que a hospedagem libere conexoes HTTPS de saida para a API do Dropbox.

Causa

Token de acesso do Dropbox revogado: a senha do Dropbox mudou, o aplicativo UpdraftPlus.Com foi removido em Configurações da conta -> Aplicativos conectados, ou o token venceu, e o UpdraftPlus não consegue mais autenticar o upload.
Autorizacao nunca concluida: o usuário clicou em autorizar mas não retornou ao painel pelo botão Complete setup, entao o token nunca foi gravado e o plugin segue sem credencial valida.
Firewall ou proxy do servidor bloqueando as conexoes de saida para api.dropboxapi.com e content.dropboxapi.com na porta 443, fazendo a etapa de upload expirar por timeout.
OpenSSL desatualizado ou certificado raiz ausente no servidor PHP, que derruba o handshake TLS com a API do Dropbox e gera erro de conexão no log.
Arquivo de backup maior que o limite de fragmento do UpdraftPlus para a chamada da API, fazendo o upload do pedaco expirar antes de concluir em conexoes lentas.

Como resolver

Leia o log da execução para isolar a etapa que falha: abra o último log do backup no painel do UpdraftPlus e procure a linha do Dropbox para saber se a falha e de token, de autorizacao incompleta ou de conexão. Ative o log de navegador completo pela constante abaixo no wp-config.php antes de rodar o backup de novo.
```
define( 'UPDRAFTPLUS_BROWSERLOG', true );
```
Reautentique a conta do Dropbox: se o log indica token revogado ou autenticacao falha, va até a aba de armazenamento remoto e use o link de reautenticacao no rodape da seção do Dropbox. Conclua o fluxo até o navegador retornar ao painel, gerando um token de acesso novo.
```
UpdraftPlus -> Configurações -> Dropbox -> Re-autenticar (link no rodape da seção)
```
Confirme que a autorizacao foi de fato concluida: depois de autorizar no site do Dropbox, e obrigatório voltar ao painel pelo botão de conclusão. Se isso não acontecer, o token não e gravado. Verifique também na conta Dropbox se o aplicativo continua conectado.
```
Dropbox -> Configurações -> Aplicativos conectados -> UpdraftPlus.Com
```
Libere a conexão de saida do servidor para a API do Dropbox: se o log aponta timeout, peca a hospedagem para liberar as conexoes HTTPS de saida para os domínios da API do Dropbox na porta 443. Teste a conectividade pelo servidor com o comando abaixo antes de rodar o backup.
```
curl -I https://api.dropboxapi.com
curl -I https://content.dropboxapi.com
```
Reduza o tamanho do fragmento de upload: em conexoes instaveis ou arquivos grandes, diminua o limite de fragmento do UpdraftPlus para que cada pedaco do upload caiba na janela de execução do servidor. Ajuste o filtro abaixo no functions.php do tema-filho ou em um plugin de snippets.
```
add_filter( 'updraftplus_split_every', function() { return 100; } );
```

PHP

<?php
// functions.php do tema-filho (ou plugin de snippets): reduz o tamanho do
// fragmento que o UpdraftPlus envia por chamada ao Dropbox. Pedacos menores
// cabem na janela de execucao do servidor e evitam timeout em conexoes lentas.
add_filter( 'updraftplus_split_every', function( $bytes ) {
    return 100; // megabytes por fragmento (padrao costuma ser bem maior)
} );

// Limpa o token de acesso do Dropbox preso em cache antes do proximo backup,
// forcando o UpdraftPlus a usar a credencial reautenticada na proxima execucao.
add_action( 'updraftplus_before_backup', function() {
    $opts = UpdraftPlus_Options::get_updraft_option( 'updraft_dropbox' );
    if ( is_array( $opts ) && isset( $opts['settings'] ) ) {
        foreach ( $opts['settings'] as $id => $setting ) {
            unset( $opts['settings'][ $id ]['tmp_access_token'] );
        }
        UpdraftPlus_Options::update_updraft_option( 'updraft_dropbox', $opts );
    }
} );

Perguntas frequentes

Por que o UpdraftPlus gera o backup mas não envia para o Dropbox?

Porque são duas etapas separadas: o arquivo e criado localmente em wp-content/updraft e so depois enviado ao Dropbox. Se o token de acesso foi revogado, a autorizacao nunca foi concluida ou o servidor não alcanca a API do Dropbox, a etapa de upload falha mesmo com o backup local pronto. O log da execução diz qual das causas ocorreu.

Como corrijo a falha de autenticacao do Dropbox no UpdraftPlus?

Va na aba de armazenamento remoto e use o link de reautenticacao no rodape da seção do Dropbox. Conclua o fluxo até o navegador retornar ao painel, o que gera um token de acesso novo. O token costuma ser revogado quando a senha do Dropbox muda ou o aplicativo UpdraftPlus.Com e removido nos aplicativos conectados da conta.

O que significa o erro expired_access_token do Dropbox no log do UpdraftPlus?

Significa que o token que o UpdraftPlus usava para enviar arquivos perdeu a validade ou foi revogado pela conta Dropbox. A correção e refazer a autorizacao pelo link de reautenticacao na seção do Dropbox, que emite um token novo. Os backups que já estavam la na pasta Apps/UpdraftPlus.Com continuam intactos.

Autorizei no Dropbox mas o painel ainda diz que não estou autenticado. Por que?

Porque o fluxo de autorizacao so termina quando o navegador volta ao painel do UpdraftPlus pelo botão de conclusão. Se a aba foi fechada antes disso, o token não e gravado e o plugin segue sem credencial. Refaca a autorizacao e aguarde o redirecionamento de volta ao painel até o fim.

O backup para no meio do envio para o Dropbox em arquivos grandes. O que faco?

Reduza o limite de fragmento do UpdraftPlus com o filtro updraftplus_split_every para um valor menor, como 100 MB, para que cada pedaco do upload conclua dentro da janela de execução do servidor. Isso evita que o pedaco expire por timeout em conexoes lentas ou em hospedagem com tempo de execução baixo.

O log mostra timeout ao conectar no Dropbox. Como resolvo?

Esse timeout costuma ser firewall ou proxy do servidor bloqueando as conexoes de saida para os domínios da API do Dropbox na porta 443. Peca a hospedagem para liberar api.dropboxapi.com e content.dropboxapi.com e confirme que o OpenSSL e os certificados raiz do PHP estão atualizados, porque um TLS quebrado também derruba a conexão.

Reautenticar o Dropbox apaga os backups que já estão la?

Não. Reautenticar so renova o token de acesso que o UpdraftPlus usa para enviar novos arquivos. As copias já gravadas na pasta Apps/UpdraftPlus.Com continuam intactas. Elas so somem se você apaga manualmente ou se a regra de retencao do plugin atinge aquelas copias antigas.

Grave

Como corrigir o erro de FTP no UpdraftPlus

O erro de FTP no UpdraftPlus ocorre quando o plugin gera o backup local mas não consegue enviar os arquivos para o servidor FTP ou SFTP, em geral por firewall do host bloqueando a saida, host digitado no formato errado ou exigencia de conexão criptografada que so a versão Premium suporta.

Grave

Como corrigir o erro de tamanho de backup que excede o limite no UpdraftPlus

O erro de tamanho de backup que excede o limite no UpdraftPlus acontece quando um arquivo zip ultrapassa o ponto de divisao (1 GB por padrão), o teto de upload do destino remoto ou os limites de PHP, fazendo o backup falhar ou parar pela metade.

Grave

Como corrigir o erro de permissão de pasta no UpdraftPlus

O erro de permissão de pasta no UpdraftPlus ocorre quando a pasta wp-content/updraft não tem permissão de escrita, deixando o botão Fazer backup agora desativado e impedindo a gravação do arquivo de backup. A correção é ajustar a permissão da pasta para 755 e o dono dos arquivos.

Atenção

Como corrigir o erro de backup incremental no UpdraftPlus

O erro de backup incremental no UpdraftPlus ocorre quando falta um backup completo de base, quando o recurso Premium não esta ativo ou quando o agendador do WordPress interrompe o processo, fazendo o incremental não rodar ou parar no meio.

Grave

Como corrigir o backup de banco de dados grande que falha no UpdraftPlus

O UpdraftPlus que não faz backup de banco grande trava numa tabela pesada (em geral wp_posts ou wp_options), expira por falta de memória PHP ou para porque o scheduler do WordPress não consegue agendar a retomada. O backup fica preso na mesma porcentagem e nunca chega ao arquivo final.

Crítico

Como corrigir site quebrado após migração do WordPress

O site quebrado após migração do WordPress aparece com layout sem CSS, imagens faltando, links apontando para o domínio antigo ou tela branca. A causa quase sempre é a URL antiga ainda gravada no banco de dados ou credenciais erradas no wp-config.php do novo servidor.

Setores

Extensões

Integrações

Como corrigir o erro de Dropbox no UpdraftPlus

O que é o erro de Dropbox no UpdraftPlus?

Como identificar

Como prevenir

Causa

Como resolver

Perguntas frequentes

Itens relacionados

Como corrigir o erro de FTP no UpdraftPlus

Como corrigir o erro de tamanho de backup que excede o limite no UpdraftPlus

Como corrigir o erro de permissão de pasta no UpdraftPlus

Como corrigir o erro de backup incremental no UpdraftPlus

Como corrigir o backup de banco de dados grande que falha no UpdraftPlus

Como corrigir site quebrado após migração do WordPress

Setores

Extensões

Integrações

Extensões

Hero Sections

Seções de CTA

Login

Blog

Cabeçalhos

Seções de FAQ

Cadastro

Blog individual

Rodapés

Seções de contato

Seções de preços

Faixas

Portfólio

Seções de equipe

Números

Logotipos