Magento

Corrigindo “Error 503: Service Unavailable” no Magento

Como corrigir o erro Error 503: Service Unavailable em uma loja Magento.

Primeiro para fazer a correção temos que entender o “erro”.

Magento possuí um mecanismo que coloca a loja em modo manutenção toda vez que está sendo instalado um módulo, backup, compilando, etc.

O que acontece as vezes é que por algum motivo esse procedimento é interrompido, fazendo que o modo de manutenção continue ativo.

Você consegue ver o mecanismo que ativa este modo analisando o código do arquivo index.php, na raiz de sua loja.

$maintenanceFile = 'maintenance.flag';

if (file_exists($maintenanceFile)) {
    include_once dirname(__FILE__) . '/errors/503.php';
    exit;
}

Código é bem simples, quando existir o arquivo maintenance.flag no diretório raiz da loja, automaticamente ela entrará no modo de manutenção.

Exemplo

Quando você instala um plugin pelo Magento Connect, o próprio Magento irá criar o arquivo maintenance.flag enquanto a instalação está ocorrendo.

Colocando a sua loja no modo de manutenção.

Mensagem completa:

Service Temporarily Unavailable

The server is temporarily unable to service your request due to maintenance downtime or capacity problems. Please try again later.

Resolvendo o Problema

Para fazer a correção deste erro é bem simples, basta acessar o FTP do servidor (hospedagem) da loja e excluir o arquivo maintenance.flag que estará localizado no diretório raiz de sua loja.

Post Recentes

CNPJ alfanumérico Magento 2: módulo grátis com máscara e validação

Módulo gratuito Roger_CnpjAlfanumerico que aplica máscara e validação do novo CNPJ alfanumérico no checkout e formulários do Magento 2 e…

4 dias atrás

CNPJ alfanumérico no WooCommerce: plugin grátis de máscara e validação

A partir de 06/07/2026 a Receita passa a emitir CNPJ alfanumérico. Conheça o plugin grátis que aplica máscara e validação…

4 dias atrás

Como remover um modulo do Magento 2

Para remover um módulo do Magento 2, siga os passos abaixo: 1. Desabilitar o módulo Primeiro, desabilite o módulo usando…

1 ano atrás

Criar um memorando de crédito (cancelar) invoice no Magento 2

Para cancelar 100% do pedido e criar um crédito para todos os itens através da API REST do Magento 2,…

2 anos atrás

Consultando no banco quantidade disponivel para Venda (estoque)

No Magento 2, a quantidade "reservada" na "Salable Quantity" é gerenciada principalmente pelos módulos MSI (Multi-Source Inventory). A "Salable Quantity"…

2 anos atrás

Admin do Magento 2 não acessa

Como corrigir o erro ao acessar o Admin do Magento 2. Mesmo após fazer o login, permanece na tela de…

2 anos atrás