---
title: "Como ativar o modo de depuração (WP_DEBUG)"
url: https://full.services/wp-fixer/ativar-wp-debug-wordpress/
date: 2026-06-13
author: "Clayton Margiotti"
---

# Como ativar o modo de depuração (WP_DEBUG)

## O que é o modo de depuração WP_DEBUG?

Ativar o debug no WordPress (a constante WP_DEBUG) significa ligar o modo de depuração definindo constantes no wp-config.php. Por padrão, o WordPress esconde os erros de PHP em produção por segurança, o que faz problemas aparecerem como tela branca, sem pista nenhuma. Com o WP_DEBUG ligado (e o WP_DEBUG_LOG), todo erro, aviso (warning) e notice passa a ser registrado em um arquivo de log, sem precisar ser mostrado ao visitante.

## Como identificar

- O site mostra tela branca ou "There has been a critical error" sem dizer qual arquivo falhou.

- Você precisa achar qual plugin ou tema está causando um erro fatal e não há mensagem visível.

- Aparecem avisos de "Deprecated" ou "Undefined array key" intermitentes que você quer registrar.

- Um desenvolvedor pediu o conteúdo do wp-content/debug.log e o arquivo ainda não existe.

**Antes de começar:** Faça backup do wp-config.php antes de editá-lo. Nunca deixe WP_DEBUG_DISPLAY como true em produção: ele expõe caminhos de arquivo e detalhes do servidor a qualquer visitante. Apague o wp-content/debug.log depois, porque ele fica acessível e pode revelar informações sensíveis.

## Como prevenir

- Use sempre WP_DEBUG_LOG com WP_DEBUG_DISPLAY false em produção, para depurar sem expor o site

- Desligue o WP_DEBUG e apague o debug.log assim que terminar o diagnóstico

- Em ambiente de staging, mantenha o debug ligado para flagrar avisos antes de subir para produção

## Erros relacionados

- [Como corrigir a Tela Branca da Morte (WSoD)](https://full.services/wp-fixer/corrigir-tela-branca-da-morte-wordpress/)

- [Como corrigir Parse error / syntax error no PHP](https://full.services/wp-fixer/corrigir-parse-error-syntax-php-wordpress/)

- [Como corrigir Allowed memory size exhausted](https://full.services/wp-fixer/corrigir-allowed-memory-size-exhausted-php/)