---
title: Solucionar problemas de visualização e publicação
description: Corresponda estados de vitrine, compilação, publicação, checkout e domínio à ação segura mais próxima.
---

**Caminho de entrada:** Espaço de trabalho → selecione uma loja → **Vitrine** → reproduza o estado de visualização ou publicação mostrado na tela

## O que este guia cobre

Identifique qual camada está falhando—versão do projeto, visualização, verificação de compilação, publicação, catálogo público, checkout ou domínio—e tome a menor ação de recuperação segura.

## Por que essa distinção é importante

A jornada da vitrine tem várias camadas independentes. Repetir **Publicar** não pode corrigir dados de produto ausentes e atualizar Preview não pode reparar uma conexão de pagamento. Comece com a mensagem exata e a superfície que falhou.

## Disponibilidade e pré-requisitos

- Mantenha o projeto aberto e anote o rótulo de versão atual.
- Registre a mensagem exata, caminho da página e se apareceu em Preview ou na URL pública.
- Aguarde o trabalho ativo do Runner atingir **Concluído**, **Falhou** ou **Parado** antes de iniciar uma ação de recuperação conflitante.
- Não remova domínios, restaure versões ou repita ações pagas apenas para testar uma teoria.

## Encontre a camada com falha

1. Em **Vitrine**, verifique se existe uma versão atual.
2. Confirme se Preview normal abre.
3. Se você está publicando, leia o resultado da verificação de compilação antes de selecionar outra ação.
4. Se a publicação for bem-sucedida, abra a URL pública em vez da URL de visualização.
5. Na loja pública, teste o catálogo e o carrinho.
6. Verifique o status de checkout do Runner e o caminho de checkout real.
7. Se apenas o endereço personalizado falhar, verifique Domain Settings por último.

## Controles de recuperação importantes

| Controle | O que acontece quando selecionado |
| --- | --- |
| **Atualizar** em Preview | Recarrega a visualização atual e limpa a seleção de Design Mode ativa e a sessão de desfazer/refazer. Salve as edições diretas pendentes primeiro. |
| **Corrigir** / **Corrigir erro** | Envia o diagnóstico de visualização exibido ao Runner como uma solicitação de reparo. **Dispensar** apenas oculta a mensagem. |
| **Corrigir com IA** | Fecha a confirmação de publicação e envia sua falha de compilação ao Runner para reparo; a publicação não é iniciada. |
| **Tentar verificação novamente** | Executa novamente a verificação de compilação da vitrine após o Runner não conseguir alcançar o workspace. |
| **Abrir Operações da loja** | Fecha a confirmação de publicação e abre Operações da Loja para que você possa completar a configuração indicada. |
| **Verificar novamente a configuração** | Verifica novamente a prontidão de Operações da Loja após seu status estar indisponível. |
| **Republicar** | Inicia uma tentativa de publicação verificada e nova após uma falha ou resultado sem link. Corrija a causa nomeada primeiro. |
| **Verificar novamente o checkout** | Verifica novamente uma conexão de pagamento ativada; não testa um produto, envio ou o formulário de checkout. |

## Referência de estado para ação

| Mensagem ou sintoma | Camada | O que significa | Ação segura mais próxima |
| --- | --- | --- | --- |
| **Ainda não há loja** | Versão do projeto | Não existe nenhuma versão que possa ser visualizada. | Peça ao Runner para criar a primeira vitrine. |
| **Construindo a primeira versão da sua loja…** | Versão do projeto | O Runner ainda está criando. | Acompanhe o progresso da tarefa; não publique ainda. |
| **Falha na compilação** em uma versão | Versão do projeto | Essa versão não está pronta. | Abra os detalhes da tarefa e peça ao Runner para reparar a falha. |
| **Preparando a pré-visualização…** | Visualização | O Runner está iniciando a visualização selecionada. | Mantenha a versão mais recente selecionada; atualize apenas se o progresso parar. |
| **Falha ao carregar a pré-visualização desta versão.** | Visualização | A versão selecionada não pôde ser exibida. | Retorne à atual, atualize ou tente outra versão pronta. |
| **Reconnecting preview** | Visualização | O Runner perdeu a conexão de visualização e está tentando novamente. | Acompanhe a contagem de tentativas; reconecte o workspace se a recuperação falhar. |
| Barra de erro de visualização com **Corrigir** | Visualização | A página em execução relatou um diagnóstico que o Runner pode usar. | Selecione **Mostrar mais** para inspecioná-lo, **Corrigir** ou **Corrigir erro** para enviá-lo ao Runner ou **Dispensar** apenas para ocultar a barra. |
| **Página não encontrada** | Rota de visualização ou pública | O caminho não existe nessa versão. | Retorne a `/`, use navegação visível e peça ao Runner para criar ou reparar a rota. |
| **O modo de design não iniciou. A pré-visualização da loja pode ainda estar acordando — tente novamente.** | Modo de Design | A visualização editável não ficou pronta. | Selecione **Tentar novamente** ou retorne à Visualização atual e atualize. |
| **Editor visual desabilitado enquanto a IA está processando** | Modo de Design | O Runner está tratando outra solicitação. | Aguarde o Runner terminar. |
| **Não foi possível carregar o histórico de versões** | Histórico de versão | A solicitação da lista de versões falhou. | Selecione **Tentar novamente**. |
| Restaurar está bloqueado | Histórico de versão | O Runner está ativo ou a versão não está pronta. | Aguarde o Runner e escolha uma versão pronta. |
| **Não foi possível acessar seu espaço de trabalho. Tente a verificação novamente para continuar.** | Verificação de publicação | O Runner não conseguiu executar a verificação de compilação. | Selecione **Verificar novamente**; reconecte o workspace se repetir. |
| **Algo deu errado ao compilar sua loja. Corrija os erros antes de publicar.** | Verificação de publicação | A vitrine atual não pode passar na compilação. | Selecione **Corrigir com IA**, revise o reparo e execute novamente as verificações. |
| **A configuração da loja está incompleta. Pode publicar agora, mas alguns detalhes operacionais ainda precisam de atenção.** | Configuração de publicação | Detalhes operacionais importantes da loja permanecem inacabados. | Selecione **Abrir Operações da loja**. Reconheça apenas se a limitação for intencional. |
| **Não foi possível verificar Operações da loja. Tente novamente ou confirme e publique mesmo assim.** | Configuração de publicação | O status de configuração é desconhecido. | Selecione **Verificar novamente a configuração** antes de considerar um reconhecimento. |
| **Nenhuma alteração de código detectada desde a última implantação.** | Alterações de publicação | O Runner não encontrou nada novo desde a última publicação. | Cancele ou reconheça uma nova implantação do mesmo estado apenas quando intencional. |
| **A integração de pagamento não está configurada. Os clientes não poderão fazer pagamentos em sua loja publicada até que você conecte o Stripe nas Configurações.** | Configuração de checkout | Alguns fluxos de publicação mostram isso antes do lançamento quando nenhuma conexão de pagamento ativada é encontrada. | Conecte o Stripe; use o reconhecimento apenas para um lançamento somente de navegação intencional. Outros fluxos relatam o status do checkout após a publicação. |
| **Falha ao publicar a loja** | Publicação | A tentativa não foi concluída. | Repare o problema indicado e selecione **Republicar**. |
| **Link da loja indisponível** | Entrega da publicação | A tentativa terminou sem uma URL pública utilizável no Runner. | Feche o diálogo, confirme que o workspace está pronto e selecione **Republicar**. |
| A loja pública mostra conteúdo antigo | Publicação ou versão | As alterações mais recentes do projeto não estão ao vivo. | Confirme a versão atual mais recente, selecione **Publicar Alterações** e reabra a URL pública. |
| Produto ausente na loja pública | Catálogo | A publicação foi bem-sucedida, mas o produto pretendido não está visível. | Verifique status do produto, mercado, preço e inventário; publique alterações se necessário. |
| Ação do carrinho ausente ou desativada | Catálogo ou disponibilidade | O item selecionado não pode ser adicionado atualmente. | Verifique opções necessárias, disponibilidade, estoque, preço e região. |
| **Checkout em pausa** | Pagamento | O fluxo pós-publicação não encontrou uma conexão Stripe ativada. | Selecione **Conectar Stripe** e teste novamente o caminho de checkout real. |
| **Estado do checkout indisponível** | Status de pagamento | O Runner não consegue confirmar a prontidão de pagamento. | Selecione **Verificar novamente o checkout** e teste o checkout público independentemente. |
| Domínio personalizado próprio mostra um aviso vermelho e uma tabela **Tipo / Host / Valor** | Domínio | A verificação da configuração atual do provedor ainda não passou. | Copie exatamente os valores exibidos para seu provedor. O Runner verifica novamente de forma automática enquanto as Configurações de Domínio permanecem abertas; não há botão de verificação manual. |
| **Transferência em andamento** | Domínio | Um domínio está se movendo entre lojas. | Não inicie outra transferência; acompanhe o status mostrado. |

## Relate um problema ao Runner

Incluir esses detalhes em uma mensagem:

1. o caminho exato da página ou URL pública;
2. se falhou em Preview ou na loja ao vivo;
3. o rótulo de versão atual;
4. o texto exato de erro ou estado;
5. o último botão que você selecionou;
6. o resultado esperado; e
7. se o problema se reproduz após a ação de tentativa documentada.

Para um problema visual, inclua o layout do dispositivo e uma captura de tela. Para checkout, pare antes de uma cobrança real e relate a última etapa bem-sucedida.

## Limites de recuperação

- Não retome ou republique repetidamente um estado com falha inalterado. Corrija a causa nomeada primeiro.
- Não restaure uma versão mais antiga enquanto o Runner está trabalhando.
- Não remova um domínio para corrigir um problema de vitrine ou checkout.
- Não declare sucesso de lançamento até que a URL pública, catálogo pretendido, carrinho e etapa de checkout necessária tenham sido verificados.

## Guias relacionados

- [Visualizar sua loja](./preview-your-store)
- [Preparar para publicar](./prepare-to-publish)
- [Publicar e republicar](./publish-and-republish)
- [Verificar a loja ativa e o checkout](./live-store-and-checkout)
- [Conectar um domínio personalizado](./custom-domains)