Alguns apps publicados mais antigos ainda podem estar conectados a um banco de dados de desenvolvimento que foi criado originalmente para um app diferente. Isso pode acontecer com apps mais antigos que foram copiados (fork) ou remixados no Replit. Na configuração legada do Neon, uma cópia poderia continuar usando a conexão do banco de dados do app original. Como parte da mudança do Replit para isolar completamente os bancos de dados de desenvolvimento e produção, os bancos de dados de desenvolvimento compartilhados mais antigos estão sendo removidos e os apps publicados precisam migrar para seus próprios bancos de dados de produção. Use este guia se seu app publicado está exibindo erros de conexão com o banco de dados, ou se oDocumentation Index
Fetch the complete documentation index at: https://docs.replit.com/llms.txt
Use this file to discover all available pages before exploring further.
DATABASE_URL no painel de Secrets ainda aponta para neon.tech.
Antes de começar
Seu app publicado precisa de seu próprio banco de dados de produção. O banco de dados de desenvolvimento exibido no painel Database não deve ser usado diretamente por apps publicados.
- Caso 1: Os dados que você precisa já estão presentes no banco de dados exibido no painel Database do seu app.
- Caso 2: O painel Database não mostra os dados de que você precisa, porque seu app publicado ainda está usando o banco de dados de desenvolvimento compartilhado mais antigo.
Como saber se seu app publicado está usando um banco de dados compartilhado?
Seu app publicado é afetado se qualquer uma das seguintes situações for verdadeira:- Seu app publicado mostra erros de conexão com o banco de dados após a atualização do banco de dados
- Seu app foi remixado de outro app que tinha um banco de dados antes de 9 de janeiro de 2026
Como verificar se seu app publicado está usando o banco de dados compartilhado do app de origem?
Etapa 1: Abra o painel Database no app de origem
NEON_DATABASE_URL ou de DATABASE_URL caso NEON_DATABASE_URL não exista.
Nem todo app afetado terá
NEON_DATABASE_URL. Se estiver ausente, isso
geralmente significa que você deve usar o DATABASE_URL atual dos Secrets do
app publicado, se ele ainda apontar para neon.tech.Etapa 2: Abra o painel Publish no app publicado
- Abra seu app no Replit
- Abra o painel Publishing
- Abra Adjust Settings
- Abra Secrets
- Procure por
DATABASE_URL
Etapa 3: Compare a URL do banco de dados do app de origem na Etapa 1 com o app remixado na Etapa 2
Se forem iguais, seu app publicado está usando um banco de dados de desenvolvimento Neon compartilhado do app de origem.Como copiar dados do app de origem para o app publicado?
Após confirmar que seu app publicado está usando o banco de dados de desenvolvimento compartilhado do app de origem, o próximo passo é transferir os dados necessários para o app publicado. Há dois cenários a considerar:- Caso 1: O painel Database no app publicado já contém os dados necessários.
- Caso 2: O painel Database no app publicado não contém os dados necessários.
Caso 1: O painel Database já mostra os dados de que você precisa
Este é o caminho mais simples se os dados de que você precisa já estão visíveis no painel Database do seu app.Etapa 1: Confirme que os dados estão presentes
Etapa 2: Publique ou republique com um banco de dados de produção
- Abra seu app no Editor de Projeto
- Selecione Publish ou Republish
- Ative Create production database
- Ative Set up your production database with your current development data
- Conclua o fluxo de publicação
DATABASE_URL para o novo banco de dados de produção. Você não precisa atualizar esse secret manualmente durante esse fluxo.
Etapa 3: Verifique o app publicado
Abra seu app publicado e confirme que seus dados estão acessíveis e que o app funciona corretamente.Caso 2: O painel Database no app publicado não mostra os dados de que você precisa
Siga estas etapas para exportar os dados se você não encontrar os dados necessários no painel Database do seu app publicado. Se seu app publicado ainda estiver conectado a um banco de dados de outro app, você verá um aviso de “banco de dados externo detectado” no painel Database.
Etapa 1: Exporte os dados do banco de dados antigo
database_url é a URL do banco de dados obtida na Etapa 1: Abra o painel Database no app de origem.
Etapa 2: Remova o DATABASE_URL antigo dos Secrets do seu app
- Abra a ferramenta Secrets no Editor de Projeto
- Encontre o
DATABASE_URLantigo - Exclua-o
- Atualize a página ou reabra o painel Database
Etapa 3: Importe os dados para o banco de dados de desenvolvimento atual do seu app
DATABASE_URL antigo for removido, o banco de dados de desenvolvimento atual do seu app deve estar disponível novamente como $DATABASE_URL no Editor de Projeto.
Volte ao Shell no Editor de Projeto e execute:
Etapa 5: Siga o Caso 1 para publicar ou republicar com um banco de dados de produção
Quando o painel Database mostrar os dados corretos, siga o Caso 1 para publicar ou republicar com Create production database e copiar esses dados para produção.Etapa 6: Verifique o app publicado
Solução de Problemas
A importação falha porque as tabelas já existem
O comandopg_restore --clean --if-exists acima descarta e recria os objetos correspondentes do dump antes de restaurá-los.
A importação falha com erros de função ou política
Se o seu banco de dados usa funções PostgreSQL personalizadas ou políticas baseadas em funções, a importação pode falhar porque essas funções não existem ainda no novo banco de dados. A migração automática Helium do Replit tenta recriar stubs de funções antes de restaurar, mas o processo manual acima não faz isso. Se você encontrar erros relacionados a funções durante opg_restore, entre em contato com o suporte para obter ajuda.