---
title: "Solução de problemas"
description: "O que verificar quando uma compilação falha, uma alteração não é publicada, um domínio continua pendente ou uma solicitação é recusada."
canonical: "https://atelier201.com/docs/pt/platform/troubleshooting"
updated: "2026-11-06"
---

# Solução de problemas

## Uma compilação falhou

Abra a compilação: `error` mostra um código e uma mensagem, e o registro exibe a saída do compilador (as mensagens do Astro). As causas mais comuns:

- Um valor de conteúdo que não corresponde ao esquema. O registro indica o campo. Corrija o conteúdo, não o esquema, a menos que você queira adicionar um novo tipo de dado.
- Uma dependência que não está disponível para a compilação. A compilação é executada sem acesso à rede, usando os [pacotes disponíveis no Atelier201](/docs/platform/packages), então projetos que adicionam outro pacote ou outra versão são recusados. `dependencies_unavailable` significa isso, e a mensagem informa o nome do pacote.
- Infraestrutura. `build_infrastructure` indica uma falha no contêiner de compilação ou no armazenamento, não nos seus arquivos. Execute a compilação novamente.

Uma compilação pronta da mesma revisão é reutilizada. Portanto, execute a compilação novamente depois de corrigir o problema, não antes.

## Publiquei, mas os visitantes ainda veem o site antigo

A publicação chega a todos os endereços em cerca de um minuto. Se a versão antiga continuar aparecendo depois disso, confira se você publicou a compilação desejada:
`atelier201 publish history` e o `published.build_id` do site mostram o que está no ar.
Publicar novamente ou reverter uma publicação reescreve o roteamento do site.

## A publicação foi recusada

| Mensagem ou código                 | Causa                                                                                                                                                     |
| ---------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `409 conflict` após uma revisão    | Alguém publicou desde a sua revisão. Revise novamente e envie o novo `expected_generation`.                                                               |
| `409 conflict` ao listar bloqueios | A compilação não pode ser publicada. Cada bloqueio informa o que fazer: consulte [Como um site é publicado](/docs/platform/drafts-builds-and-publishing). |
| `403 insufficient_scope`           | A credencial não tem `sites:publish`. Peça ao proprietário para publicar ou reconecte com esse escopo.                                                    |
| `403 admin_required`               | Somente um administrador do espaço de trabalho pode publicar.                                                                                             |

## Uma alteração foi recusada por conflito

Você editou um arquivo que alguém alterou desde que você o leu. O `details` do erro contém a revisão atual e os caminhos. Leia esses arquivos novamente e aplique sua alteração sobre a versão atual.

## Um domínio continua pendente

Um domínio passa de `pending_ownership` para `provisioning` e depois para `active` quando seus registros estão configurados. Se continuar em `pending_ownership`, o registro TXT está faltando ou ainda não se propagou. Compare-o com os registros no app, aguarde e verifique o domínio novamente. Um conflito com uma mensagem sobre o plano significa que o site não tem mais domínios personalizados disponíveis: remova um ou passe o site para um plano superior.

## Um limite do plano foi atingido

A publicação de um rascunho é recusada com `403 feature_not_available`; criar um rascunho além do limite de rascunhos do espaço de trabalho e conectar um domínio a um rascunho são recusados com `409 conflict`. Cada mensagem indica o limite e inclui um link para a página que permite aumentá-lo (`action_url`). Passe o site para o plano Site ou exclua um rascunho e tente novamente. Um agente não deve repetir a tentativa em loop nem alterar o plano por conta própria.

## Meu saldo de créditos parece incorreto

O saldo corresponde à soma dos créditos concedidos que ainda não expiraram, menos os créditos utilizados. A página **Cobrança** lista cada crédito concedido e sua data de expiração. Somente recursos de IA consomem créditos: o assistente e as imagens ou os vídeos criados com IA.

## Não consigo entrar

Confira qual endereço de e-mail está associado à conta. Uma conta criada com o Google e outra criada com uma senha só são a mesma conta se usarem o mesmo endereço.