Content is not allowed in prolog: перевірка початку XML
XSDHub · 4 листопада 2026 року
Що означає проблема
Помилка прологу означає, що початок вхідних даних не відповідає очікуваній розмітці XML. Різні обробники описують схожий випадок словами Content is not allowed in prolog або Start tag expected. Оригінальна діагностика залежить від бібліотеки, тому орієнтуйтеся на фактичний вміст файла перед кореневим елементом, а не лише на текст повідомлення.
З чого почати перевірку
Перед коренем у помилковому прикладі стоїть ERROR. Це звичайний текст поза дозволеною структурою документа. Виправлений XML починається з root і читається успішно. Навчальна заміна ізолює причину, але в інтеграції спершу потрібно встановити, чому сторонній текст потрапив у результат: його міг додати журналювальний код або обробник винятків.
Як працює приклад
Якщо файл отримано через HTTP, перегляньте код відповіді та тип вмісту. Замість документа сервіс міг повернути сторінку входу, текст відмови або JSON із деталями помилки. Збереження відповіді під розширенням .xml не змінює її формату. Відновіть авторизацію чи виправте запит у джерелі, а потім повторно отримайте потрібні дані.
На що звернути увагу
XML-декларація, коли вона присутня, повинна стояти на початку з урахуванням дозволеної позначки кодування. Пробіл перед декларацією може викликати окрему помилку її розташування. Якщо декларації немає, пробільні символи перед коренем допустимі. Тому автоматичне обрізання всього до першого знака < не є надійним загальним виправленням і може приховати іншу проблему.
Як застосувати виправлення
Коректна позначка BOM для UTF-8 сама собою не означає пошкодження XML. Досліджуйте неправильне декодування, повторну позначку чи сторонні байти окремо. Порівняйте приклади без схеми, а після відновлення читабельності додайте XSD за потреби. Успішний розбір початку файла підтверджує лише синтаксис; відповідність формату одержувача визначається наступним етапом перевірки.
Перевірте приклади самостійно
Відкрити безкоштовний інструмент. Порівняйте помилковий і виправлений документи. Використовуйте режим синтаксису XML.
XML з помилкою — очікується відмова
ERROR<root>Дані</root>Виправлений XML — очікується успіх
<root>Дані</root>