---
title: "Solución de problemas"
description: "Qué comprobar si falla una compilación, un cambio no se publica, un dominio sigue pendiente o se rechaza una solicitud."
canonical: "https://atelier201.com/docs/es/platform/troubleshooting"
updated: "2026-11-06"
---

# Solución de problemas

## Ha fallado una compilación

Abre la compilación: `error` muestra un código y un mensaje, y el registro incluye la salida del compilador (los mensajes de Astro). Estas son las causas más habituales:

- Un valor de contenido que no coincide con su esquema. El registro indica el campo. Corrige el contenido, no el esquema, salvo que quieras añadir un nuevo tipo de datos.
- Una dependencia que la compilación no tiene. La compilación se ejecuta sin acceso a la red y solo con los [paquetes disponibles en Atelier201](/docs/platform/packages), por lo que se rechaza cualquier proyecto que añada otro paquete u otra versión. `dependencies_unavailable` indica este problema y el mensaje especifica el paquete.
- La infraestructura. `build_infrastructure` indica que ha fallado el contenedor de compilación o el almacenamiento, no tus archivos. Vuelve a compilar.

Se reutiliza una compilación correcta de la misma revisión, así que vuelve a compilar después de corregir el problema, no antes.

## He publicado y los visitantes siguen viendo el sitio antiguo

La publicación llega a todas las direcciones en aproximadamente un minuto. Si después de ese tiempo sigue apareciendo la versión antigua, comprueba que hayas publicado la compilación que querías: `atelier201 publish history` y el `published.build_id` del sitio indican qué versión está publicada. Si vuelves a publicar o haces una reversión, se actualiza el enrutamiento del sitio.

## Se rechaza la publicación

| Mensaje o código                       | Causa                                                                                                                                                 |
| -------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| `409 conflict` después de una revisión | Alguien ha publicado desde que revisaste. Vuelve a revisar y envía el nuevo `expected_generation`.                                                    |
| `409 conflict` al mostrar los bloqueos | La compilación no se puede publicar. Cada bloqueo indica qué hacer: consulta [Cómo se publica un sitio](/docs/platform/drafts-builds-and-publishing). |
| `403 insufficient_scope`               | La credencial no tiene `sites:publish`. Pide al propietario que publique o vuelve a conectarte con ese ámbito.                                        |
| `403 admin_required`                   | Solo un administrador del espacio de trabajo puede publicar.                                                                                          |

## Se ha rechazado un cambio por un conflicto

Has escrito en un archivo que alguien modificó desde que lo leíste. `details` del error contiene la revisión actual y las rutas. Vuelve a leer esos archivos y aplica el cambio sobre la versión actual.

## Un dominio sigue pendiente

Un dominio pasa de `pending_ownership` a `provisioning` y después a `active` cuando sus registros están configurados. Si permanece en `pending_ownership`, falta el registro TXT o aún no se ha propagado. Compáralo con los registros de la aplicación, espera y vuelve a comprobar el dominio. Si un conflicto muestra un mensaje sobre el plan, significa que el sitio ya no puede tener más dominios personalizados: elimina uno o cambia el sitio a un plan superior.

## Se ha alcanzado el límite del plan

Se rechaza la publicación de un borrador con `403 feature_not_available`. También se rechaza crear un borrador que supere el límite del espacio de trabajo o conectar un dominio a un borrador, en ambos casos con `409 conflict`. Cada mensaje indica el límite y enlaza a la página para ampliarlo (`action_url`). Cambia el sitio al plan Site o elimina un borrador y vuelve a intentarlo. Un agente no debe repetir el intento en bucle ni cambiar el plan por su cuenta.

## El saldo de créditos no parece correcto

El saldo es la suma de los créditos concedidos que no han caducado, menos los que se han utilizado. En la página **Facturación** se muestran todas las concesiones y sus fechas de caducidad. Solo las funciones de IA consumen créditos: el asistente y las imágenes o vídeos generados con IA.

## No puedo iniciar sesión

Comprueba qué dirección de correo electrónico utiliza la cuenta. Una cuenta creada con Google y otra creada con contraseña solo son la misma cuenta si comparten la dirección.