Está vendo erros ou avisos de banco de dados no relatório do instalador após a restauração de um backup? A maioria remonta a um pequeno número de causas bem conhecidas, e cada uma tem uma correção específica abaixo.

Este guia cobre a resolução de erros e avisos de banco de dados no relatório do instalador do Duplicator Pro, desde incompatibilidades de collation até consultas excessivamente grandes.

Erros de Gravação

Durante a instalação, erros e avisos relacionados ao banco de dados geralmente estão ligados a dados do arquivo [hash]-dump.sql que falham ao serem inseridos no novo banco de dados. Consultas que geram erro durante a instalação são registradas no log do instalador. Abra installer-log.txt e procure pela seção DATABASE RESULTS, onde os erros são marcados como ERROR. O Duplicator Pro se conecta diretamente a installer-log.txt a partir de qualquer aviso de erro mostrado durante a instalação, então não há necessidade de navegar manualmente pelo servidor para encontrá-lo.

As causas mais comuns incluem:

• Versões do Banco de Dados: Incompatibilidades podem ocorrer se as versões do MySQL diferirem significativamente entre os servidores. Confirme se a versão do MySQL ou MariaDB do servidor de destino é igual ou mais nova que a versão do servidor de origem antes de solucionar mais problemas.
• Modo MySQL: O Modo MySQL pode afetar como o motor MySQL processa as consultas.

Definir o Modo MySQL como NO_ENGINE_SUBSTITUTION

Se o installer-log.txt mostrar “database error write ‘Invalid default value…'”, defina o Modo MySQL como NO_ENGINE_SUBSTITUTION. Recomendamos definir isso inicialmente se muitos erros de banco de dados ocorrerem.

1. Na Etapa 1 do instalador, mude para Modo Avançado.
2. Abra a aba Database e localize o campo Mode.
3. Selecione o botão de rádio Custom e insira NO_ENGINE_SUBSTITUTION.
   
4. Continue com a instalação.
5. Após a conclusão da instalação, verifique o log do instalador (link disponível no canto superior direito) em busca de erros.

Experimente várias combinações para determinar o que funciona melhor para o seu servidor. Assim que identificar uma configuração funcional, trabalhe com seu provedor ou administrador de servidor para definir esses valores permanentemente no arquivo my.ini.

Strings de Erro Comuns e Correções

Erros de Limite de Tamanho de Consulta

Se você encontrar erros relacionados ao 'Limite de tamanho da consulta', isso significa que a carga de dados excede o que é permitido pela sua configuração do MySQL. Para resolver isso, edite seu arquivo de configuração my.cnf (ou my.ini) e adicione ou atualize a configuração max_allowed_packet, por exemplo max_allowed_packet=64M. Para mais detalhes, consulte o tamanho do pacote MySQL.

Visão Geral do Relatório do Instalador

O relatório do instalador na etapa final foi projetado para destacar possíveis problemas com a instalação. Observe que, em alguns casos, você pode receber erros ou avisos que não afetam a funcionalidade geral do seu site. Se o seu site estiver estável e a contagem de resultados de Implantação/Atualização for baixa (abaixo de 10), você geralmente poderá ignorar esses erros ou avisos menores.

Erros de Atualização

Estas são instruções básicas de consulta que encontraram problemas durante a execução no novo servidor. Eles podem ser causados por problemas de integridade de dados ou incompatibilidades entre diferentes versões do MySQL. Se os erros aparecerem aqui, inspecione a consulta e depure o problema de migração.

Avisos de Chave de Tabela

Esses avisos ocorrem quando o novo valor de URL de uma tabela é detectado, mas não pode ser atualizado porque não há uma chave de tabela correspondente. Localize e atualize esses valores manualmente.

Avisos de Serialização

Problemas de serialização PHP podem ocorrer quando valores internos mudam. O Duplicator Pro tenta reparar strings serializadas automaticamente, mas em casos raros elas não são atualizadas corretamente. Para corrigir uma string serializada manualmente:

1. Localize a string serializada problemática usando a consulta fornecida no relatório do instalador.
2. Visite unserialize.onlinephp.io.
3. Cole a string serializada, por exemplo a:1:{s:4:"Test";s:17:"unserialize here!";}. O segmento s:4:"Test"; denota uma string com 4 caracteres. Se a contagem de caracteres não corresponder ao comprimento real da string, a desserialização gerará um erro.
4. Ajuste a contagem de caracteres para corresponder ao comprimento real da string para corrigir o problema.

Verificação Rápida

Se você receber algum erro no relatório do instalador, siga estas etapas:

1. Confirme se o site funciona corretamente. Se estiver estável e o número de erros for baixo, salve novamente as configurações do tema, plugin ou widget afetado.
2. Se você ainda estiver preocupado, execute as consultas SQL fornecidas no relatório do instalador e revise o log de erros para avaliar consultas problemáticas. Você também pode realizar essa verificação usando phpMyAdmin.

É isso! Seguir as etapas deste guia resolve a maioria dos erros e avisos comuns do banco de dados no relatório de instalação do Duplicator Pro, para que sua migração ou restauração seja concluída de forma limpa.

Veja também:
Como corrigir problemas de gravação no banco de dados?
Como corrigir problemas de conexão com o banco de dados?
Provedores de hospedagem recomendados para Duplicator?