---
title: "Risoluzione dei problemi"
description: "Cosa verificare quando una build non riesce, una modifica non è online, un dominio resta in attesa o una richiesta viene rifiutata."
canonical: "https://atelier201.com/docs/it/platform/troubleshooting"
updated: "2026-11-06"
---

# Risoluzione dei problemi

## Una build non è riuscita

Apri la build: `error` fornisce un codice e un messaggio, mentre il log mostra l'output del compilatore (i messaggi di Astro). Le cause più comuni:

- Un valore del contenuto che non corrisponde allo schema. Il log indica il campo. Correggi il contenuto, non lo schema, a meno che tu non voglia aggiungere un nuovo tipo di dato.
- Una dipendenza non disponibile per la build. La build viene eseguita senza accesso alla rete e usa i [pacchetti disponibili su Atelier201](/docs/platform/packages), quindi un progetto che aggiunge un altro pacchetto o una versione diversa viene rifiutato. `dependencies_unavailable` indica questo problema e il messaggio specifica il pacchetto.
- Un problema dell'infrastruttura. `build_infrastructure` indica un problema del container di build o dello spazio di archiviazione, non dei tuoi file. Esegui di nuovo la build.

Una build pronta della stessa revisione viene riutilizzata, quindi esegui di nuovo la build dopo aver applicato una correzione, non prima.

## Ho pubblicato, ma i visitatori vedono ancora il vecchio sito

La pubblicazione raggiunge tutti gli indirizzi in circa un minuto. Se la vecchia versione è ancora visibile dopo questo intervallo, verifica di aver pubblicato la build prevista:
`atelier201 publish history` e `published.build_id` del sito indicano quale versione è online.
Pubblicare di nuovo o eseguire un rollback riscrive il routing del sito.

## La pubblicazione viene rifiutata

| Messaggio o codice                      | Causa                                                                                                                                                    |
| --------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `409 conflict` dopo una revisione       | Qualcuno ha pubblicato dopo la tua revisione. Esegui di nuovo la revisione e invia il nuovo `expected_generation`.                                       |
| `409 conflict` con l'elenco dei blocchi | La build non può essere messa online. Ogni blocco indica cosa fare: consulta [Come va online un sito](/docs/platform/drafts-builds-and-publishing).      |
| `403 insufficient_scope`                | La credenziale non dispone dell'autorizzazione `sites:publish`. Chiedi al proprietario di pubblicare oppure riconnettiti includendo tale autorizzazione. |
| `403 admin_required`                    | Solo un amministratore del workspace può pubblicare.                                                                                                     |

## Una modifica è stata rifiutata per un conflitto

Hai modificato un file che qualcuno aveva cambiato dopo che lo avevi letto. `details` dell'errore contiene la revisione corrente e i percorsi. Rileggi quei file e applica le tue modifiche alla versione più recente.

## Un dominio resta in attesa

Un dominio passa da `pending_ownership` a `provisioning` e poi ad `active` quando i suoi record sono disponibili. Se resta in `pending_ownership`, il record TXT manca o non si è ancora propagato. Confrontalo con i record indicati nell'app, attendi e verifica di nuovo il dominio. Un conflitto con un messaggio relativo al piano significa che al sito non resta alcun dominio personalizzato: rimuovine uno oppure passa il sito a un piano superiore.

## È stato raggiunto un limite del piano

La pubblicazione di una bozza viene rifiutata con `403 feature_not_available`; la creazione di una bozza oltre il limite del workspace e la connessione di un dominio a una bozza vengono rifiutate con `409 conflict`. Ogni messaggio indica il limite e include un collegamento alla pagina che permette di rimuoverlo (`action_url`). Passa il sito al piano Site oppure elimina una bozza, quindi riprova. Un agente non deve riprovare all'infinito né modificare autonomamente il piano.

## Il saldo dei crediti non sembra corretto

Il saldo corrisponde alla somma dei crediti non scaduti, meno quelli utilizzati. La pagina **Fatturazione** elenca ogni accredito e la relativa data di scadenza. Solo le funzioni AI consumano crediti: l'assistente e le immagini o i video creati con l'AI.

## Non riesco ad accedere

Verifica quale indirizzo email è associato all'account. Un account creato con Google e uno creato con una password sono lo stesso account solo se usano lo stesso indirizzo.