Solução de problemas comuns com instalações do WordPress com falha (erros de permissão, falhas de conexão com o banco de dados etc.)

O processo de instalação do WordPress geralmente ocorre sem problemas, mas os novatos podem encontrar alguns avisos de erro. Esses problemas podem parecer complicados e complexos, mas podem ser facilmente resolvidos se você descobrir a causa. Esta seção resume os problemas comuns de instalações com falha e as soluções específicas para ajudá-lo a solucionar rapidamente os problemas e concluir a instalação.

I. Falha na conexão com o banco de dados (o erro mais comum)

mau comportamento

A instalação exibe: "Erro ao estabelecer uma conexão com o banco de dados" ou "Erro ao estabelecer uma conexão com o banco de dados" e você não pode prosseguir para a próxima etapa.

Possíveis causas e soluções

1. Informações incorretas do banco de dados (no caso do 90%)
   • pontos de controleNome do banco de dados: se o nome do banco de dados, o nome de usuário e a senha são os mesmos do registro (diferencia maiúsculas de minúsculas).
   • Etapas do exercício：
     1. Faça login no painel do Pagoda e vá para a página "Database" (Banco de dados) para confirmar o nome do banco de dados e o nome de usuário.
     2. Se a senha estiver incorreta, clique em "More" → "Change Password" para gerar uma nova senha e registrá-la.
     3. Retorne à página de instalação, preencha novamente com as informações corretas e envie.
2. Erro no endereço do host do banco de dados
   • pontos de controleO "Host do banco de dados" está correto (quase sempre para iniciantes)?localhost）。
   • Etapas do exercício：
     1. PadrãolocalhostNão são necessárias modificações.
     2. Se o provedor do servidor tiver instruções especiais (por exemplo, alguns hosts no exterior), preencha o endereço fornecido (por exemplomysql.example.com）。
3. Serviço de banco de dados não iniciado
   • pontos de controleMySQL: Se o serviço MySQL no servidor está sendo executado corretamente.
   • Etapas do exercício：
     1. Faça login no painel do Pagoda e clique em "Software Store" no lado esquerdo.
     2. Localize a instalação do MySQL e verifique se o status é "Running" (Em execução).
     3. Se ele não estiver em execução, clique no botão "Restart" (Reiniciar) para iniciar o serviço.
4. O usuário do banco de dados não tem privilégios
   • pontos de controleSe o usuário do banco de dados tem permissão para acessar o banco de dados.
   • Etapas do exercício：
     1. Faça login no painel do Pagoda e vá para "Bancos de dados" → Clique em "Gerenciar" depois de Bancos de dados e vá para o phpMyAdmin.
     2. Clique em "User Account" (Conta de usuário) no menu superior para localizar o usuário do banco de dados correspondente.
     3. Confirme se o usuário tem "Todos os direitos" sobre o banco de dados de destino; caso contrário, autorize novamente.

II. erro de permissão (incapaz de criar arquivo/gravar configuração)

mau comportamento

Dica: "Cannot write to wp-config.php file" ou "Unable to create directory", a instalação é interrompida.

Possíveis causas e soluções

1. Permissões insuficientes para o catálogo do site
   • pontos de controleSe as permissões do diretório raiz da Web no servidor estão definidas corretamente.
   • Etapas do exercício：
     1. Faça login no Painel do Pagoda, acesse "Sites" → Encontre o site correspondente e clique em "Mais" → "Privilégios".
     2. Defina "Directory Permissions" (Permissões de diretório) como 755Se a "Permissão de arquivo" estiver definida como 644。
     3. Opções de propriedade www(ou o usuário de tempo de execução padrão do servidor), clique em Apply (Aplicar).
2. Crie manualmente o arquivo wp-config.php
   • Se for solicitado um arquivo de configuração que não possa ser gravado, crie-o manualmente:
     1. Na página Erros de instalação, clique em "Criar perfil" e copie o código da página.
     2. Faça login no Pagoda Panel, vá para o diretório raiz do site, clique em "New File" (Novo arquivo), nomeie-o como wp-config.php。
     3. Clique duas vezes no arquivo para abrir o editor, cole o código copiado e clique em "Salvar".
     4. Volte para a página de instalação e clique em "Proceed with installation" (Continuar com a instalação) para continuar.
3. Erro de propriedade do arquivo
   • pontos de controleSe o arquivo pertence ao usuário que está executando o servidor (por exemplo, o usuário que está executando o Apache ou o Nginx).
   • Etapas do exercício：
     1. No Pagoda File Manager, selecione o diretório raiz do site e clique em "Permissions" (Permissões).
     2. Altere o "Owner" (Proprietário) e o "Group" (Grupo) para o usuário de tempo de execução do servidor (geralmente o www ou nginx）。
     3. Marque "Apply to subdirectories" (Aplicar a subdiretórios) e clique em "OK".

III. interrupção do processo de instalação ou tela branca

mau comportamento

Na metade da instalação, ela trava repentinamente, a página fica em branco (tela branca) ou a mensagem "500 Internal Server Error" é exibida.

Possíveis causas e soluções

1. Incompatibilidade de versão do PHP
   • pontos de controleSe a versão do PHP do servidor atende aos requisitos do WordPress (recomendado 7.4 e superior).
   • Etapas do exercício：
     1. Faça login no Pagoda Panel, vá para "Website" → Localize o site correspondente e clique em "PHP Version".
     2. Selecione PHP 7.4 ou 8.0 (para melhor compatibilidade) e clique em 'Switch'.
     3. Alterne e acesse novamente a página de instalação.
2. Limite insuficiente de memória do PHP
   • pontos de controleLimite de memória do PHP: o limite de memória do PHP é muito baixo, causando a interrupção do processo de instalação.
   • Etapas do exercício：
     1. Faça login no Pagoda Panel, vá para "Software Store" → Localize o PHP instalado e clique em "Settings".
     2. Vá para "Profiles" (Perfis) e procure por memory_limit, altere o valor para 128M ou 256M。
     3. Clique em Salvar para reiniciar o serviço PHP.
3. Arquivos de instalação corrompidos ou incompletos
   • pontos de controleO pacote de instalação do WordPress carregado não está corrompido.
   • Etapas do exercício：
     1. Faça novamente o download do pacote de instalação do WordPress a partir da fonte oficial (consulte a seção 7.1).
     2. Faça login no painel do Pagoda e exclua todos os arquivos no diretório raiz do site.
     3. Faça o upload novamente e extraia o novo pacote de instalação (consulte a seção 7.2) e inicie a instalação novamente.

IV. Outros erros e soluções comuns

1. O nome de domínio não está sendo resolvido ou a porta do servidor não está aberta
   • mau comportamentoPágina de instalação: A página de instalação não pode ser aberta ao acessar o nome de domínio, mostrando "Não é possível acessar este site".
   • Etapas do exercício：
     1. Verifique se o nome do domínio foi resolvido para o IP do servidor (consulte a Seção 4.4).
     2. Faça login no console do servidor e verifique se as portas 80 (HTTP) e 443 (HTTPS) estão abertas.
     3. Se estiver acessando por IP, verifique se o Painel do Pagode não restringe o acesso por IP.
2. Conflitos de prefixo de tabela de banco de dados
   • mau comportamentoTabela já existe" ou os dados estão bagunçados após a instalação.
   • Etapas do exercício：
     1. Se o WordPress tiver sido instalado anteriormente, faça login no phpMyAdmin e exclua as tabelas do banco de dados antigo.
     2. ou modificar os prefixos da tabela durante a instalação (por exemplo, alterar o prefixo wp_ mudar para wp2023_）。
3. Bloqueio de firewall ou plug-in de segurança
   • mau comportamentoA página de instalação carrega lentamente ou está bloqueada.
   • Etapas do exercício：
     1. Desative temporariamente o firewall do servidor ou as regras do grupo de segurança (ative-os após a conclusão da instalação).
     2. Se estiver usando um servidor doméstico, verifique se ele está bloqueado devido a problemas de arquivamento (a porta 80/443 não está disponível para domínios não registrados).

Dicas gerais para a solução de erros

1. Visualização do registro de erros
   • Faça login no Pagoda Panel, acesse "Sites" → "Logs" do site correspondente e visualize o "Error Log", que registrará a causa específica do erro.
2. Ambiente de instalação simplificado
   • Se for usada uma configuração de servidor complexa, restaure temporariamente as configurações padrão (por exemplo, extensões PHP, regras pseudoestáticas etc.).
3. pedir ajuda
   • Copie o texto da mensagem de erro e procure uma solução em um mecanismo de pesquisa (geralmente é possível encontrar soluções para problemas semelhantes).
   • Entre em contato com o atendimento ao cliente do provedor do servidor e forneça capturas de tela do erro para que um técnico possa ajudar na solução do problema.

curto

A maioria das falhas de instalação é causada por preenchimento incorreto de informações, configurações de permissão inadequadas ou ambientes incompatíveis. Seguindo os métodos desta seção para verificar um a um, os problemas do 99% podem ser resolvidos. Se várias tentativas ainda falharem, é recomendável reorganizar o processo: desde a criação do banco de dados, o upload de arquivos até o preenchimento de informações, cada etapa é cuidadosamente verificada para garantir que a operação esteja correta.

Depois de resolver o problema, você estará no caminho certo para entrar no backend do WordPress e começar a criar seu site.