Erro ‘Database Schema Mismatch’ no Notion: Etapas de Resolução
🔍 WiseChecker

Erro ‘Database Schema Mismatch’ no Notion: Etapas de Resolução

Você vê uma faixa vermelha com a mensagem Database Schema Mismatch ao tentar abrir um banco de dados do Notion. Esse erro ocorre quando a estrutura de um banco de dados na sua tela não corresponde à estrutura armazenada nos servidores do Notion. A incompatibilidade geralmente acontece após uma sincronização falha, uma chamada de API corrompida ou um conflito entre dois usuários editando o mesmo banco de dados ao mesmo tempo. Este artigo explica a causa raiz e fornece métodos passo a passo para resolver o erro e restaurar o acesso aos seus dados.

Principais conclusões: Correção do Database Schema Mismatch no Notion

  • Recarregue a página com Ctrl+R ou Cmd+R: Força o Notion a buscar novamente o esquema do banco de dados do servidor, limpando uma incompatibilidade de cache local.
  • Duplique o banco de dados pelo menu de três pontos: Cria uma cópia nova do banco de dados com um novo ID de esquema, ignorando o erro de incompatibilidade.
  • Exporte e reimporte o banco de dados como Markdown ou CSV: Remove os metadados de esquema corrompidos e reconstrói a estrutura do zero.

Por que o erro Database Schema Mismatch ocorre

Um banco de dados do Notion é definido por um esquema: um conjunto de colunas, tipos de propriedade e links de relação. Toda vez que você abre um banco de dados, o Notion compara o esquema armazenado no cache do seu navegador com o esquema no servidor. Uma incompatibilidade significa que essas duas versões diferem. Gatilhos comuns incluem:

  • Uma requisição de rede interrompida enquanto o Notion salvava uma alteração de propriedade.
  • Dois usuários renomeando uma coluna ou alterando um tipo de propriedade simultaneamente.
  • Uma integração de terceiros, como Zapier ou Make, enviando uma requisição de API malformada que corrompe o esquema.
  • Uma extensão de navegador que bloqueia ou modifica o payload JavaScript do Notion.

O erro não significa perda de dados. Suas linhas e valores de propriedade permanecem intactos no servidor. O problema é que o Notion não consegue exibir o banco de dados porque não sabe qual esquema usar.

Etapas para resolver o Database Schema Mismatch

Siga estes métodos em ordem. Pare quando o erro desaparecer. Não pule a primeira etapa.

Método 1: Forçar um recarregamento completo da página

  1. Pressione Ctrl+R ou Cmd+R
    Isso recarrega a página atual e força o Notion a solicitar novamente o esquema do banco de dados do servidor. Não use o botão voltar do navegador nem a navegação da barra lateral do Notion.
  2. Aguarde 10 segundos após o recarregamento
    O Notion pode precisar de tempo para comparar os esquemas. Se a faixa vermelha desaparecer, a correção está completa.
  3. Se o erro persistir, pressione Ctrl+Shift+R ou Cmd+Shift+R
    Isso realiza um recarregamento forçado que limpa todo o cache do navegador para a página do Notion. Repita a etapa 2.

Método 2: Duplicar o banco de dados

  1. Clique no menu de três pontos no canto superior direito da página do banco de dados
    O menu está localizado ao lado do botão Compartilhar e do título da página.
  2. Selecione Duplicar no menu suspenso
    O Notion cria uma cópia do banco de dados no mesmo espaço de trabalho. A duplicata recebe um novo ID de esquema no servidor.
  3. Abra o banco de dados duplicado
    Se o erro não aparecer, mova seu conteúdo do banco de dados antigo para o novo arrastando linhas ou usando copiar e colar. Exclua o banco de dados original após confirmar que todos os dados estão intactos.

Método 3: Exportar e reimportar o banco de dados

  1. Clique no menu de três pontos e escolha Exportar
    Selecione Markdown e CSV como formato de exportação. O Notion baixará um arquivo ZIP contendo um arquivo CSV para cada visualização do banco de dados e um arquivo Markdown para cada página.
  2. Crie um novo banco de dados em branco no Notion
    Clique no botão + na barra lateral, selecione Banco de dados e escolha Tabela. Nomeie o novo banco de dados.
  3. Abra o arquivo CSV em um editor de texto ou aplicativo de planilha
    Remova colunas desnecessárias. Certifique-se de que os cabeçalhos das colunas correspondam aos nomes das propriedades no seu novo banco de dados do Notion.
  4. Clique no menu de três pontos no novo banco de dados e selecione Importar
    Escolha o arquivo CSV. O Notion reconstruirá o esquema a partir do arquivo. O erro de incompatibilidade não deve aparecer porque o esquema é criado do zero.

Se o Notion ainda mostrar o erro Schema Mismatch

O erro persiste após um recarregamento forçado e duplicação

A corrupção pode estar nos links de relação do banco de dados. Abra o banco de dados em uma visualização diferente, como Calendário ou Lista. Se uma visualização carregar corretamente, exclua a visualização quebrada e recrie-a. Para excluir uma visualização, clique na aba do nome da visualização, selecione o ícone de engrenagem e escolha Excluir visualização.

O erro aparece apenas em um dispositivo

Limpe o cache do navegador para o domínio do Notion. No Chrome, vá em Configurações > Privacidade e segurança > Limpar dados de navegação. Selecione Imagens e arquivos em cache e defina o intervalo de tempo como Todo o período. Recarregue o Notion.

O erro aparece após usar uma integração de terceiros

Desconecte a integração do espaço de trabalho. Vá em Configurações e Membros > Conexões. Encontre a integração e clique em Desconectar. Em seguida, recarregue o banco de dados. Se o erro desaparecer, a integração estava enviando atualizações de esquema malformadas. Reconecte a integração e teste com um único banco de dados antes de restaurar o acesso completo.

Database Schema Mismatch vs Outros Erros no Notion

Item Database Schema Mismatch Falha na Sincronização do Banco de Dados
Mensagem de erro Faixa vermelha: Database Schema Mismatch Faixa amarela: Falha na Sincronização ou Alterações Não Salvas
Causa raiz IDs de esquema local e do servidor diferentes Interrupção de rede durante uma operação de gravação
Risco de perda de dados Nenhum Alterações recentes podem ser perdidas
Correção principal Recarregar, duplicar ou exportar/reimportar Verificar conexão de rede e aguardar nova tentativa automática
Links de relação afetados Sim, colunas de relação podem quebrar Não

O erro Database Schema Mismatch é específico para corrupção estrutural. O erro Falha na Sincronização do Banco de Dados é um problema temporário de rede. Se você vir ambos os erros no mesmo banco de dados, resolva a falha de sincronização primeiro garantindo uma conexão de internet estável e, em seguida, siga as etapas para o mismatch.

Agora você pode identificar e corrigir um erro Database Schema Mismatch no Notion usando recarregamento de página, duplicação do banco de dados ou exportação e reimportação. Após resolver o erro, verifique se todas as colunas de relação ainda estão vinculadas aos bancos de dados de destino corretos. Para prevenção contínua, evite renomear propriedades do banco de dados enquanto outro usuário tiver o mesmo banco de dados aberto. Use o comando Duplicar como um backup rápido antes de fazer alterações em massa no esquema.