Documentación

DOC / 15 / OPERACIÓN

Errores y diagnósticos

Interpreta códigos PLG estables, fallos de build en navegador, diagnósticos JSON, códigos de salida y recuperación.

En esta guíaErrores y diagnósticos
Primeros pasosEstructura del proyectoReferencia del CLIBucle de desarrolloRouting y páginasVistas RustEventos y foldsSchemas y snapshotsSync verificado con HyphaeContenido tipadoRuntime del navegadorPropiedad del DOMAssets adaptativosConfianza de artefactosErrores y diagnósticosBuild y despliegueCrates y APILicenciamiento y políticas

Fallos de build en el navegador

pliego dev inicia incluso cuando falla la compilación inicial del sitio. Las solicitudes de documentos reciben una página diagnóstica HTTP 500 de marca con el código estable, salida del compilador escapada y la siguiente acción. Guardar un fix recompila y recarga la página automáticamente.

Códigos diagnósticos estables

Un código diagnóstico identifica el contrato que falla, no la redacción de una versión del compilador. El tooling puede asociar el código y estado de salida; las personas reciben el mensaje y la acción de recuperación.

text
PLG-BLD-001 / BUILD FAILED
The site package did not compile.

error[E0425]: cannot find value `titel` in this scope

NEXT
Correct the reported source error and save the file.

Superficies de fallo HTTP

404
El /404.html con autoría del proyecto o un fallback de marca del framework
405
Método rechazado con header Allow
414
Request target sobredimensionado rechazado antes de resolver el filesystem
500
Fallo actual del build de desarrollo o artefacto de documento ilegible
503
La cola limitada está llena; se devuelve Retry-After

Flujo de recuperación

  1. 01

    Lee el código

    Comienza con PLG-BLD, PLG-ENV, PLG-ART o la categoría mostrada en el navegador.

  2. 02

    Corrige la primera causa

    La salida del compilador está ordenada; errores posteriores pueden ser consecuencias.

  3. 03

    Guarda y observa

    El watcher recompila y la página diagnóstica recarga sin reiniciar pliego dev.

  4. 04

    Verifica producción

    Ejecuta pliego build y pliego inspect después de que la página de desarrollo esté verde.