Solucionar problemas de visualização e publicação
Corresponda estados de vitrine, compilação, publicação, checkout e domínio à ação segura mais próxima.
As capturas de tela e as gravações mostram a interface em inglês. Os nomes dos controles podem variar conforme o idioma selecionado.
Caminho de entrada: Espaço de trabalho → selecione uma loja → Loja virtual → 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ída, 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
- Em Loja virtual, verifique se existe uma versão atual.
- Confirme se Preview normal abre.
- Se você está publicando, leia o resultado da verificação de compilação antes de selecionar outra ação.
- Se a publicação for bem-sucedida, abra a URL pública em vez da URL de visualização.
- Na loja pública, teste o catálogo e o carrinho.
- Verifique o status de checkout do Runner e o caminho de checkout real.
- 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. |
| Correção / Corrigir erro | Envia o diagnóstico de visualização exibido ao Runner como uma solicitação de reparo. Descartar 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. |
As anotações em inglês indicam os controles. Selecione a imagem para ampliá-la.
Uma compilação aprovada pode aparecer ao lado de um aviso de configuração. Leia ambos antes de decidir se a loja está pronta.
Referência de estado para ação
| Mensagem ou sintoma | Camada | O que significa | Ação segura mais próxima |
|---|---|---|---|
| Nenhuma versão pronta da vitrine | Versão do projeto | Não existe versão que possa ser visualizada. | Peça ao Runner que construa 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. |
| Build falhou 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évia… | Visualização | O Runner está iniciando a visualização selecionada. | Mantenha a versão mais recente selecionada; atualize apenas se o progresso parar. |
| Não foi possível mostrar esta versão — tente novamente ou escolha outra. | 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 Correção | Visualização | A página em execução relatou um diagnóstico que o Runner pode usar. | Selecione Mostrar mais para inspecioná-lo, Correção ou Corrigir erro para enviá-lo ao Runner ou Descartar 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évia da loja ainda pode estar iniciando — tente novamente. | Modo de Design | A visualização editável não ficou pronta. | Selecione Tentar novamente ou retorne à Visualização atual e atualize. |
| Você poderá editar visualmente de novo assim que o Runner terminar o processamento. | Modo de design | O Runner está atendendo outra solicitação. | Espere o Runner terminar. |
| Não foi possível carregar suas versões — tente novamente. | 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 workspace. 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 Tentar verificação novamente; reconecte o espaço se o erro se repetir. |
| Sua loja ainda não pode ser gerada, então não pode ir ao ar. Deixe o Runner corrigir os erros e depois publique. | Verificação de publicação | A vitrine atual não passa na compilação. | Selecione Corrigir com IA, revise o reparo e execute as verificações novamente. |
| Alguns detalhes operacionais ainda precisam da sua atenção. Você pode publicar agora e concluí-los em Operações da loja. | Configuração da publicação | Operações importantes da loja continuam incompletas. | Selecione Abrir Operações da loja. Aceite somente 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 da publicação | O estado da configuração é desconhecido. | Selecione Verificar novamente a configuração antes de aceitar o aviso. |
| Faça uma alteração visível na sua loja antes de publicar. | Alterações para publicação | O Runner não encontrou novidades desde a última publicação. | Cancele e faça a alteração desejada primeiro. Confirmar fica desativado quando não há alterações para publicar. |
| Os compradores podem navegar, mas ainda não podem pagar — conecte o Stripe em Configurações para receber pedidos. | Configuração do checkout | Alguns fluxos mostram este aviso antes do lançamento quando não encontram uma conexão de pagamento habilitada. | Para uma loja nativa do Runner, conecte o Stripe; aceite o aviso somente para um lançamento intencional sem pagamentos. Outros fluxos informam o estado 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 o 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. |
Confirme a recuperação
Volte à mesma página, versão e tamanho de dispositivo em que ocorreu a falha. Repita uma vez a menor etapa que falhou. Confira o resultado visível: uma prévia pronta, uma publicação bem-sucedida com a página esperada no endereço público, um carrinho correto ou um domínio funcionando. Registre separadamente qualquer etapa que ainda falhe.
Relate um problema ao Runner
Incluir esses detalhes em uma mensagem:
- o caminho exato da página ou URL pública;
- se falhou em Preview ou na loja ao vivo;
- o rótulo de versão atual;
- o texto exato de erro ou estado;
- o último botão que você selecionou;
- o resultado esperado; e
- 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.