Внутренние ошибки

Docara проверяет не только проект, но и себя: что её собственные описания компонентов, шаблоны и промежуточные данные сборки согласованы. Эти проверки не зависят от текста страниц и настроек — если такая ошибка появилась, дело не в вашем проекте.

Что делать

Выполните полную сборку ещё раз: docara build <окружение>. Иногда ошибку вызывает прерванная прошлая сборка.
Проверьте, что Docara установлена целиком и не изменена вручную: composer install восстановит файлы пакета из composer.lock.
Если ошибка повторяется, сообщите о ней в репозиторий Docara. Приложите код, вывод docara doctor --json и, если можно, страницу, на которой сборка остановилась. Не прикладывайте пароли и токены.

Не обходите ошибку правкой результата сборки: следующая сборка его заменит.

Коды внутренних проверок

Разбор страницы

Промежуточное представление страницы, которое Docara строит перед выводом.

Код	Что проверяется
`DOCUMENT_AST_EMPTY`, `DOCUMENT_AST_INVALID`, `DOCUMENT_IR_EMPTY`, `DOCUMENT_INPUT_INVALID`	Страница разобрана в непустую корректную структуру
`DOCUMENT_IR_SOURCE_LOCATION_INVALID`, `DOCUMENT_IR_SOURCE_NODE_TYPE_INVALID`, `DOCUMENT_SOURCE_SPAN_INVALID`	У каждого блока есть точное место в исходном файле
`DOCUMENT_HEADING_INVALID`, `DOCUMENT_LINK_INVALID`, `DOCUMENT_MARKDOWN_NODE_INVALID`	Заголовки, ссылки и обычный Markdown разобраны без потерь
`DOCUMENT_IR_COMPONENT_NODE_INVALID`, `DOCUMENT_IR_COMPONENT_BLOCK_NODE_INVALID`, `DOCUMENT_IR_CONTAINER_NODE_INVALID`, `DOCUMENT_COMPONENT_RENDERER_NODE_INVALID`, `DOCUMENT_COMPONENT_BLOCK_RENDERER_NODE_INVALID`	Блоки и компоненты переданы на вывод в ожидаемом виде
`DOCUMENT_SMART_CALL_NODE_INVALID`, `DOCUMENT_SMART_COMPONENT_NODE_INVALID`, `DOCUMENT_SMART_COMPONENT_ORDINAL_INVALID`, `DOCUMENT_SMART_VIEW_INVALID`	Вызовы Smart-компонентов пронумерованы и переданы на вывод целиком
`DOCUMENT_CONTAINER_CONTRACT_MISSING`, `DOCUMENT_CONTAINER_ORDER_INVALID`, `DOCUMENT_CONTAINER_SLOT_INVALID`, `DOCUMENT_CONTAINER_DEPTH_SEMANTICS_INVALID`, `DOCUMENT_CONTAINER_RENDERER_INVALID`, `DOCUMENT_CONTAINER_RENDERER_UNSUPPORTED`, `DOCUMENT_CONTAINER_CHILD_ARTIFACTS_REQUIRED`	У полосы, сетки и карточки есть полное описание вложенности
`DOCUMENT_IR_RENDERER_UNKNOWN`, `DOCUMENT_IR_RENDERER_DUPLICATE`	Для каждого вида блока есть ровно один способ вывода
`DOCUMENT_OUTLINE_PARSE_FAILED`, `DOCUMENT_OUTLINE_SERIALIZE_FAILED`	Оглавление построено по готовой странице

Вывод страницы

Код	Что проверяется
`PAGE_BUILDER_FAILED`	Обёртка над ошибкой вывода страницы: в сообщении после двоеточия — исходная причина. Если в ней есть другой код, ищите его в этом справочнике.
`PAGE_BUILDER_DOCUMENT_ARTIFACT_REQUIRED`, `PAGE_BUILDER_DOCUMENT_IR_REQUIRED`, `RENDER_ARTIFACT_HTML_REQUIRED`	Каждая страница получила разобранный документ и готовый HTML
`RESOLVED_BLOCK_PLAN_INVALID`, `RESOLVED_RENDER_PLAN_INVALID`, `RESOLVED_SMART_PLAN_INVALID`, `COMPOSITION_RECIPE_PAGE_RESULT_INVALID`	План вывода страницы собран целиком
`DECLARATIVE_BLOCK_RENDERER_UNSUPPORTED`, `DECLARATIVE_DOCUMENT_ELEMENT_INVALID`, `DECLARATIVE_DOCUMENT_MARKDOWN_INVALID`, `DECLARATIVE_DOCUMENT_NODES_REQUIRED`, `DECLARATIVE_DOCUMENT_NODE_INVALID`, `DECLARATIVE_DOCUMENT_NODE_RESOLVERS_REQUIRED`, `DECLARATIVE_DOCUMENT_NODE_RESOLVER_DUPLICATED`, `DECLARATIVE_DOCUMENT_RENDERERS_REQUIRED`, `DECLARATIVE_DOCUMENT_RENDERER_DUPLICATED`, `DECLARATIVE_DOCUMENT_SMART_INVALID`, `DECLARATIVE_REGION_SMART_INVALID`	Шаблон страницы получил все части документа и областей
`LAYOUT_DESCRIPTOR_INVALID`, `LAYOUT_REGION_INVALID`, `NAVIGATION_SCOPE_INVALID`	Описание макета, его областей и навигации согласовано
`SURFACE_SEMANTIC_FRAME_INVALID`, `SURFACE_SEMANTIC_PADDING_INVALID`, `SURFACE_SEMANTIC_TONE_INVALID`, `SURFACE_PADDING_2XL_REQUIRES_CONTAINER`	Оформление полосы и первого экрана получило проверенные значения
`MARKDOWN_HERO_EFFECT_ANCHOR_MISSING`	У первого экрана с фоновым эффектом есть место для эффекта
`SMART_INVOCATION_INVALID`, `SMART_TEMPLATE_CONTEXT_INVALID`, `SMART_CONTEXT_BRANDING_INVALID`	Шаблон Smart-компонента получил полный набор данных

Встроенные описания Docara

Код	Что проверяется
`TYPED_COMPONENT_SOURCE_INVALID`, `TYPED_COMPONENT_DEFINITION_INVALID`, `TYPED_COMPONENT_DEFINITION_MISMATCH`, `TYPED_COMPONENT_DUPLICATE`, `TYPED_COMPONENT_RENDERER_UNKNOWN`	Описания блоков Docara на месте, не повторяются и совпадают с кодом вывода
`CONTENT_COMPONENT_REGISTRY_EMPTY`, `CONTENT_COMPONENT_DEFINITION_INVALID`, `CONTENT_COMPONENT_TEMPLATE_INVALID`, `CONTENT_COMPONENT_ALIAS_INVALID`, `CONTENT_COMPONENT_ALIAS_MISMATCH`, `CONTENT_COMPONENT_PROP_CONTRACT_INVALID`, `CONTENT_COMPONENT_SLOT_CONTRACT_INVALID`, `CONTENT_COMPONENT_NORMALIZATION_INVALID`	Описания строчных компонентов корректны
`SCHEMA_INVALID`, `SCHEMA_NOT_FOUND`	Схемы настроек входят в пакет и читаются
`NATIVE_MARKDOWN_PROFILE_INVALID`	Набор поддерживаемых конструкций Markdown совпадает с включёнными расширениями
`DOCARA_AI_CONTRACT_INVALID`, `DOCARA_AI_CONTRACT_MISSING`	Описание возможностей для AI-агента входит в пакет
`SDK_RESULT_CONTRACT_INVALID`	Ответ команды с `--json` соответствует своей схеме
`TARGET_SITE_JSON_FORBIDDEN`, `TARGET_PUBLIC_INPUT_FORBIDDEN`, `TARGET_COMPOSITION_KIND_INVALID`, `TARGET_CONFIG_PROSE_FORBIDDEN`, `TARGET_COMPONENT_PROSE_FORBIDDEN`	Файлы пакета не попадают во входные данные сайта, а тексты страниц не хранятся в настройках компонентов

Сборка оболочки и каталоги

Что проверяется	Коды
Каталог компонентов собран полностью: у каждого компонента есть владелец, источник, проверенные варианты и честные ограничения	`COMPONENT_CATALOG_DUPLICATE_ID`, `COMPONENT_CATALOG_ENTRY_INVALID`, `COMPONENT_CATALOG_FAMILY_CONTRACT_INVALID`, `COMPONENT_CATALOG_GAP_INCOMPLETE`, `COMPONENT_CATALOG_GAP_OWNER_REQUIRED`, `COMPONENT_CATALOG_HASH_MISMATCH`, `COMPONENT_CATALOG_ID_INVALID`, `COMPONENT_CATALOG_MANIFEST_REFERENCE_MISMATCH`, `COMPONENT_CATALOG_METADATA_INVALID`, `COMPONENT_CATALOG_ORDER_INVALID`, `COMPONENT_CATALOG_OVERCLAIM_FORBIDDEN`, `COMPONENT_CATALOG_PATH_INVALID`, `COMPONENT_CATALOG_PROVENANCE_UNSAFE`, `COMPONENT_CATALOG_PROVIDER_REVISION_MISMATCH`, `COMPONENT_CATALOG_PUBLIC_SLUG_INVALID`, `COMPONENT_CATALOG_REFERENCE_MISSING`, `COMPONENT_CATALOG_REQUIREMENT_EXECUTABLE_FORBIDDEN`, `COMPONENT_CATALOG_SMART_ADMISSION_MISMATCH`, `COMPONENT_CATALOG_SMART_CONSTRAINTS_INVALID`, `COMPONENT_CATALOG_SMART_METADATA_INVALID`, `COMPONENT_CATALOG_SMART_METADATA_PROVENANCE_FORBIDDEN`, `COMPONENT_CATALOG_SMART_METADATA_WIDENS_MANIFEST`, `COMPONENT_CATALOG_SMART_POLICY_MISMATCH`, `COMPONENT_CATALOG_SMART_PROP_ENUM_INVALID`, `COMPONENT_CATALOG_SMART_PROP_INVALID`, `COMPONENT_CATALOG_SMART_PROP_RULE_INVALID`, `COMPONENT_CATALOG_SMART_PROP_TYPE_UNSUPPORTED`, `COMPONENT_CATALOG_SMART_PROVENANCE_MISMATCH`, `COMPONENT_CATALOG_SOURCE_INVALID`, `COMPONENT_CATALOG_SUPPORTED_EVIDENCE_REQUIRED`, `COMPONENT_CATALOG_UNSUPPORTED_DEMO_FORBIDDEN`, `COMPONENT_CATALOG_VARIANT_COVERAGE_MISMATCH`, `COMPONENT_CATALOG_VARIANT_COVERAGE_REQUIRED`, `COMPONENT_SOURCE_METADATA_HASH_MISMATCH`, `COMPONENT_SOURCE_METADATA_INVALID`, `COMPONENT_SOURCE_METADATA_MISSING`, `COMPONENT_SOURCE_METADATA_ORDER_INVALID`, `COMPONENT_SOURCE_METADATA_REFERENCE_MISSING`
Шаблоны оболочки, их данные и подключение стилей	`DECLARATIVE_BLADE_CACHE_UNAVAILABLE`, `DECLARATIVE_BLADE_COMPILE_FAILED`, `DECLARATIVE_DEFINITION_INVALID`, `DECLARATIVE_DEFINITION_MISSING`, `DECLARATIVE_DOCUMENT_NODE_CONTRACT_INVALID`, `DECLARATIVE_DOCUMENT_NODE_UNSUPPORTED`, `DECLARATIVE_DOCUMENT_RENDERER_UNSUPPORTED`, `DECLARATIVE_GENERATED_ASSET_INVALID`, `DECLARATIVE_GENERATED_ASSET_PUBLICATION_FAILED`, `DECLARATIVE_MOBILE_TOC_HEADING_CONTRACT_INVALID`, `DECLARATIVE_NAVIGATION_NODE_INVALID`, `DECLARATIVE_OUTLINE_ITEM_INVALID`, `DECLARATIVE_PORTABLE_TEMPLATE_CONTEXT_INVALID`, `DECLARATIVE_PRIMARY_ASSET_BASE_INVALID`, `DECLARATIVE_PRIMARY_COPY_REQUIRED`, `DECLARATIVE_PRIMARY_INPUT_REQUIRED`, `DECLARATIVE_PRIMARY_REGIONS_REQUIRED`, `DECLARATIVE_PUBLISHER_ASSET_INVALID`, `DECLARATIVE_PUBLISHER_ASSET_MISSING`, `DECLARATIVE_PUBLISHER_ASSET_PUBLICATION_FAILED`, `DECLARATIVE_RENDERED_CONTENT_PARITY_FAILED`, `DECLARATIVE_SHELL_ASSET_MISSING`, `DECLARATIVE_SHELL_STYLESHEET_LINKS_INVALID`, `DECLARATIVE_SMART_ASSET_INVALID`, `DECLARATIVE_SMART_ASSET_MISSING`, `DECLARATIVE_SMART_ASSET_PUBLICATION_FAILED`, `DECLARATIVE_SMART_PROVIDER_UNAVAILABLE`, `DECLARATIVE_TEMPLATE_CONTEXT_INVALID`, `DECLARATIVE_TEMPLATE_EMPTY`, `DECLARATIVE_TEMPLATE_NOT_ALLOWED`, `DECLARATIVE_TEMPLATE_UNSAFE`, `DECLARATIVE_THEME_ASSET_INVALID`, `DECLARATIVE_VIEW_IDENTITY_INVALID`, `DECLARATIVE_VIEW_REGION_UNRESOLVED`, `DECLARATIVE_VIEW_SLOT_UNRESOLVED`, `DECLARATIVE_VIEW_UTILITY_REGISTRY_INVALID`, `DECLARATIVE_VIEW_UTILITY_REGISTRY_MISSING`, `PORTABLE_LOCAL_ASSET_RECEIPT_INVALID`
Реестр Smart-компонентов и способы их вывода	`SMART_CONTEXT_ADAPTER_DUPLICATE`, `SMART_CONTEXT_ADAPTER_UNKNOWN`, `SMART_PROVIDER_ADAPTER_INVALID`, `SMART_PROVIDER_DESCRIPTOR_MISMATCH`, `SMART_PROVIDER_DUPLICATE`, `SMART_PROVIDER_RESOLVER_DUPLICATE`, `SMART_REGISTRY_ASSET_NOT_FOUND`, `SMART_REGISTRY_DUPLICATE_ALIAS`, `SMART_REGISTRY_DUPLICATE_ASSET`, `SMART_REGISTRY_DUPLICATE_COMPONENT`, `SMART_REGISTRY_KEY_MISMATCH`, `SMART_REGISTRY_TEMPLATE_NOT_FOUND`, `SMART_RENDER_STRATEGY_DUPLICATE`, `SMART_RENDER_STRATEGY_UNKNOWN`, `SMART_TEMPLATE_ABI_UNKNOWN`
Реестр привязок данных и встроенных дизайн-описаний	`BINDING_ALIAS_COLLISION`, `BINDING_DESCRIPTOR_INVALID`, `BINDING_DUPLICATE`, `BINDING_NAMESPACE_COLLISION`, `BINDING_NAMESPACE_FORBIDDEN`, `BINDING_NAMESPACE_INVALID`, `BINDING_PROVENANCE_INVALID`, `BINDING_PROVIDER_DUPLICATE`, `BINDING_RESOLVER_OUTPUT_FORBIDDEN`, `DESIGN_PROVIDER_DUPLICATE`, `DESIGN_PROVIDER_INVALID`, `DESIGN_PROVIDER_NAMESPACE_INVALID`
Повторная проверка значка, бейджа, кнопки, клавиши и предупреждения — обычно раньше срабатывает код `MARKDOWN_…` из раздела «Ошибки страниц и Markdown»; язык содержимого, справочник настроек и настройки читателя	`CONTENT_COMPONENT_BLOCK_CONTENT_REQUIRED`, `CONTENT_COMPONENT_BLOCK_HEADING_REQUIRED`, `CONTENT_COMPONENT_DOCUMENT_BODY_REQUIRED`, `CONTENT_COMPONENT_INLINE_BODY_FORBIDDEN`, `CONTENT_COMPONENT_SLOT_REQUIRED`, `CONTENT_COMPONENT_UNKNOWN`, `CONTENT_LANGUAGE_ROOT_INVALID`, `PUBLIC_SCHEMA_DESCRIPTIONS_INVALID`, `PUBLIC_SCHEMA_REFERENCE_INVALID`, `PUBLIC_SCHEMA_REFERENCE_UNKNOWN`, `READER_PREFERENCE_DUPLICATE`, `READER_PREFERENCE_UNKNOWN`

Отметки успешных проверок

docara doctor, docara validate и их вывод --json перечисляют и пройденные проверки — со статусом pass. Это не ошибки: исправлять ничего не нужно.

Код	Что прошло проверку
`PROJECT_CONFIG_VALID`	Настройки проекта
`SCHEMA_CATALOG_VALID`	Каталог схем настроек
`SMART_REGISTRY_VALID`, `DESIGN_REGISTRY_VALID`, `BINDING_REGISTRY_VALID`	Списки Smart-компонентов, дизайн-описаний и привязок; рядом — их количество
`DESIGN_ARTIFACT_VALID`	Одно дизайн-описание
`PAGE_MARKDOWN_VALID`	Markdown одной страницы
`DOCUMENTATION_SOURCES_VALID`, `DOCUMENTATION_SOURCE_VALID`	Источники отслеживания документации: все и один
`PROJECT_REGISTRIES_VALID`	Все реестры проекта вместе; рядом — число компонентов и дизайн-описаний
`COMPOSITION_EXPANDED`, `SAFE_VIEW_TREE_VALIDATED`	Каркас страницы собран из областей, а его дерево прошло проверку тегов и атрибутов
`AUTHOR_EXECUTABLE_SURFACES`	Со статусом `absent`: в настройках страницы нет шаблонов и кода

См. также