Как устранить ошибку «Непредвиденный символ при чтении JSON» в 1С: полное руководство

Ошибка «Непредвиденный символ при чтении JSON» в 1С:Предприятие — одна из самых распространённых проблем при работе с обменом данными, интеграцией с внешними сервисами или обработкой веб-запросов. Она возникает, когда система пытается распарсить JSON-строку, но сталкивается с некорректным форматом: лишними запятыми, отсутствующими кавычками, неэкранированными символами или вовсе битой структурой. Чаще всего ошибка появляется в сценариях:

— Обмен данными между 1С и сайтом (например, через HTTPСервис или REST API).

— Импорт/экспорт JSON-файлов в обработках.

— Работа с внешними API (банки, маркетплейсы, логистические сервисы).

В этой статье мы разберём все возможные причины ошибки, от тривиальных опечаток до сложных случаев с кодировками и экранированием, а также дадим пошаговые инструкции по исправлению — от ручной правки JSON до автоматизированной валидации в коде 1С. Особое внимание уделим типичным «подводным камням», о которых не пишут в официальной документации.

1. Что означает ошибка «Непредвиденный символ при чтении JSON»?

Сообщение об ошибке появляется, когда встроенный парсер 1С (методы ПрочитатьJSON(), ЗаписатьJSON() или аналогичные) не может корректно интерпретировать входную строку. Причины делятся на три категории:

• 🔹 Синтаксические ошибки: пропущенные кавычки, запятые, скобки, неверные символы (например, ‘ вместо ").
• 🔹 Проблемы с кодировкой: JSON пришёл в UTF-8 с BOM, а 1С ожидает Windows-1251, или наоборот.
• 🔹 Логические ошибки: несоответствие структуры JSON ожидаемой схеме (например, массив вместо объекта).

Важно: 1С не всегда указывает точную позицию ошибки в строке. Например, если в JSON пропущена запятая после 10-го элемента массива, парсер может «сломаться» только на 20-м элементе, выдавая некорректное сообщение. Это усложняет диагностику.

2. Типичные причины ошибки и как их выявить

Рассмотрим самые распространённые сценарии, при которых возникает проблема, и способы их идентификации.

2.1. Опечатки в ручном JSON

Если вы формируете JSON-строку вручную (например, в обработке), велик риск пропустить кавычку или запятую. Пример ошибочного кода:

ТекстJSON = '{
"Имя": "Иван",
"Фамилия": "Петров"  // <-- пропущена запятая перед следующим полем
"Отчество": "Сидорович"
}';

🔍 Как проверить:

Используйте онлайн-валидаторы JSON (например, JSONLint). Они подсветят ошибку и укажут строку.

2.2. Неэкранированные специальные символы

JSON требует экранирования символов типа \, ", /, \n. Если в данных есть, например, текст с кавычками ("Цена: "100 руб.""), парсер «споткнётся».

❌ Ошибочно:

"Описание": "Товар "Премиум" класса"

✅ Правильно:

"Описание": "Товар \"Премиум\" класса"

2.3. Проблемы с кодировкой

Если JSON пришёл из внешнего источника (например, ответ от API), его кодировка может не совпадать с ожидаемой в 1С. Классический случай: сервер отдаёт UTF-8, а 1С пытается прочитать как Windows-1251, в результате появляются «кракозябры» или невидимые символы (например, BOM).

🔍 Как выявить:

Откройте JSON-файл в Notepad++ или VS Code — в строке состояния отобразится реальная кодировка. Если видите UTF-8-BOM, удалите BOM (например, через Правка → Преобразования → Преобразовать в UTF-8 (без BOM)).

2.4. Несоответствие структуры JSON ожидаемой схеме

Иногда JSON технически корректен, но его структура не совпадает с той, что ожидает 1С. Например, API вернул массив, а ваш код рассчитан на объект. В этом случае парсер не выдаст ошибку синтаксиса, но дальнейшая обработка данных завершится сбоем.

🔍 Пример:

Вы ожидаете:

{
"Товары": [
{"Наименование": "Товар 1"},
{"Наименование": "Товар 2"}
]
}

А пришло:

[
{"Наименование": "Товар 1"},
{"Наименование": "Товар 2"}
]

2.5. Битые данные от внешнего API

Некоторые API (особенно банковские или государственные) могут возвращать JSON с невидимыми управляющими символами (например, \x00 или \x1F). Такие символы не видны в текстовом редакторе, но ломают парсинг.

🔍 Как проверить:

Используйте СтрЗначениеВВнутр(ТекстJSON) в 1С — это покажет все непечатаемые символы в виде ~X.

3. Пошаговая инструкция: как исправить ошибку

Алгоритм действий зависит от источника JSON. Ниже — универсальная схема для большинства случаев.

Шаг 1: Валидация JSON

Перед парсингом в 1С проверьте JSON на корректность:

1. Скопируйте строку JSON в валидатор (например, JSON Formatter).
2. Если есть ошибки — исправьте их вручную или автоматически (многие валидаторы предлагают опцию Fix JSON).
3. Убедитесь, что структура соответствует ожидаемой (объект vs массив).

Шаг 2: Проверка кодировки

Если JSON читается из файла или ответа HTTP-запроса:

• 📄 Откройте файл в Notepad++ и посмотрите кодировку в строке состояния.
• 🔄 При необходимости конвертируйте в UTF-8 без BOM.
• 📝 В коде 1С явно укажите кодировку при чтении:

  ТекстJSON = Новый ЧтениеТекста(ИмяФайла, КодировкаТекста.UTF8).Прочитать();

Шаг 3: Очистка от невидимых символов

Добавьте в код обработку для удаления управляющих символов:

Функция ОчиститьJSON(ТекстJSON)
// Удаляем непечатаемые символы (кроме \t, \n, \r)
Для Сч = 0 По 31 Цикл
Если НЕ (Сч = 9 Или Сч = 10 Или Сч = 13) Тогда
ТекстJSON = СтрЗаменить(ТекстJSON, Символ(Сч), "");
КонецЕсли;
КонецЦикла;
Возврат ТекстJSON;
КонецФункции

Шаг 4: Экранирование специальных символов

Если в данных есть кавычки или обратные слэши, используйте СтрШаблон() или JSON.ЭкранироватьСтроку() (в новых версиях платформы):

ТекстJSON = JSON.ЭкранироватьСтроку(ТекстJSON); // Для платформы 8.3.20+
// Или вручную:
ТекстJSON = СтрЗаменить(ТекстJSON, """", "\"\"");
ТекстJSON = СтрЗаменить(ТекстJSON, "\", "\\");

Шаг 5: Отладка через ЗаписьJSON/ЧтениеJSON

Если ошибка возникает при обмене данными, временно сохраните JSON в файл и проверьте его содержимое:

ЗаписьJSON = Новый ЗаписьJSON;
ЗаписьJSON.УстановитьСтроку();
ЗаписьJSON.ЗаписатьJSON(ВашиДанные);
ТекстJSON = ЗаписьJSON.Закрыть();

// Сохраняем для проверки
ТекстJSON.Записать("C:\temp\debug.json", КодировкаТекста.UTF8);

Проверьте JSON на синтаксические ошибки в валидаторе|Убедитесь в корректной кодировке (UTF-8 без BOM)|Очистите JSON от невидимых символов|Экранируйте специальные символы (кавычки, слэши)|Сравните структуру JSON с ожидаемой схемой-->

4. Распространённые ошибки при работе с JSON в 1С

Даже опытные разработчики 1С иногда упускают нюансы, которые приводят к сбоям. Разберём топ-5 «подводных камней».

4.1. Использование одинарных кавычек вместо двойных

JSON строго требует двойные кавычки для строковых значений. Одинарные (') или обратные (`) недопустимы:

❌ {"Name": 'Иван'}  // Ошибка!
✅ {"Name": "Иван"}

4.2. Запятые после последнего элемента

В JSON запрещены запятые после последнего элемента объекта или массива:

❌ {
"Field1": "Value1",
"Field2": "Value2",  // <-- Лишняя запятая
}
✅ {
"Field1": "Value1",
"Field2": "Value2"
}

4.3. Неправильное экранирование Unicode-символов

Символы вне ASCII (например, кириллица) должны быть в UTF-8. Если вы вручную экранируете их как \uXXXX, убедитесь в корректности кода:

❌ "Привет": "\u0440\u0438\u0432\u0435\u0442"  // Неверный порядок байт
✅ "Привет": "Привет"  // Или корректное экранирование: "\u041F\u0440\u0438\u0432\u0435\u0442"

4.4. Пустые значения без указания типа

JSON не поддерживает Null в качестве значения по умолчанию. Если поле может быть пустым, явно укажите null:

❌ {"Field": }  // Ошибка!
✅ {"Field": null}

4.5. Передача бинарных данных в JSON

JSON предназначен для текста. Если нужно передать бинарные данные (например, картинку), закодируйте их в Base64:

ДвоичныеДанные = ПолучаемКартинку();
ТекстBase64 = Base64Строка(ДвоичныеДанные);
JSON.Добавить("Image", ТекстBase64);

5. Автоматизация проверки JSON в 1С

Чтобы избежать ошибок в будущем, внедрите в код автоматические проверки. Ниже — готовые функции для типичных задач.

5.1. Функция валидации JSON

Используйте этот код для проверки корректности JSON перед парсингом:

Функция ПроверитьJSON(ТекстJSON)
Попытка
ЧтениеJSON = Новый ЧтениеJSON;
ЧтениеJSON.УстановитьСтроку(ТекстJSON);
ЧтениеJSON.ПрочитатьJSON();  // Если ошибка — вылетит исключение
Возврат Истина;
Исключение
Возврат Ложь;
КонецПопытки;
КонецФункции

5.2. Логгирование ошибок парсинга

Добавьте в обработчик ошибок запись в лог с детализацией:

Попытка
Данные = JSON.ПрочитатьJSON(ТекстJSON);
Исключение
ЗаписатьВЛог("Ошибка JSON: " + ОписаниеОшибки());
ЗаписатьВЛог("Проблемный JSON: " + Сред(ТекстJSON, 1, 500));  // Первые 500 символов
КонецПопытки;

5.3. Преобразование типов данных

JSON не различает типы чисел (все числа — Number). В 1С это может привести к неожиданностям. Используйте явное приведение:

Если ТипЗнч(Значение) = Тип("Число") Тогда
Если Значение = Цел(Значение) Тогда
Значение = Цел(Значение);  // Приводим к целому типу
Иначе
Значение = Окр(Значение, 2);  // Округляем дробное
КонецЕсли;
КонецЕсли;

6. Примеры исправления реальных ошибок

Разберём конкретные кейсы из практики и способы их решения.

Кейс 1: Ошибка при чтении ответа от API банка

Ситуация: При получении выписки из банка через API приходит ответ с ошибкой Непредвиденный символ: .

Причина: Банк возвращает JSON с BOM (невидимый символ в начале файла).

Решение:

ТекстJSON = СокрЛП(ТекстJSON);  // Удаляем BOM и лишние пробелы
Если Лев(ТекстJSON, 1) = Символ(65279) Тогда  // Проверяем на BOM (UTF-8)
ТекстJSON = Сред(ТекстJSON, 2);
КонецЕсли;

Кейс 2: Ошибка при импорте JSON из Excel

Ситуация: Пользователь экспортировал данные из Excel в JSON, но при чтении в 1С возникает ошибка на символе #.

Причина: Excel экранирует символы не по стандарту JSON.

Решение:

Используйте промежуточный конвертер (например, Python-скрипт) или очищайте JSON вручную:

ТекстJSON = СтрЗаменить(ТекстJSON, "#", "\#");

Кейс 3: Ошибка при обмене с сайтом на Bitrix

Ситуация: При отправке заказа на сайт возвращается ошибка Непредвиденный символ: &.

Причина: В данных есть HTML-сущности (например, &), которые не экранированы.

Решение:

Декодируйте сущности перед формированием JSON:

ТекстJSON = СтрЗаменить(ТекстJSON, "&", "&");
ТекстJSON = СтрЗаменить(ТекстJSON, "&", "\u0026");  // Экранируем & как Unicode

7. Таблица: Частые символы-причины ошибок и их исправление

8. Профилактика ошибок при работе с JSON в 1С

Чтобы минимизировать риск ошибок, следуйте этим рекомендациям:

• 🔧 Всегда валидируйте JSON перед парсингом — даже если он генерируется автоматически.
• 📌 Используйте типизированные структуры:

  Данные = JSON.ПрочитатьJSON(ТекстJSON, Истина);  // Второй параметр — строгая типизация

• 🔄 Тестируйте обмен данными на тестовых серверах перед боем.
• 📂 Логгируйте все JSON-запросы/ответы для отладки.
• 🛠 Обновляйте платформу 1С — в новых версиях улучшена работа с JSON.

🔹 Для разработчиков:

Используйте библиотеку json-serializer из GitHub — она поддерживает расширенные возможности (например, работу с датами и двоичными данными).

🔹 Для пользователей:

Если вы получаете JSON от партнёров (например, выгрузку из Excel), требуйте, чтобы файлы проходили валидацию перед отправкой.

FAQ: Частые вопросы по ошибке JSON в 1С

ТекстJSON = СтрЗаменить(ТекстJSON, "//", "");  // Удаляем однострочные комментарии
ТекстJSON = СтрЗаменить(ТекстJSON, "/*", "");
ТекстJSON = СтрЗаменить(ТекстJSON, "*/", "");

// Из строки ISO в дату 1С
Дата = ПарситьДатаИзJSON("2026-05-20T14:30:00Z");

// Из даты 1С в строку ISO
СтрокаДата = Формат(ТекущаяДата(), "ДФ=yyyy-MM-ddTHH:mm:ssZ");

⚠️ Внимание: Если вы работаете с API государственных систем (например, ФНС, ПФР), их JSON-ответы могут содержать недокументированные символы или структуры. Всегда тестируйте обмен на тестовых контурах перед боем.

⚠️ Внимание: В версиях 1С:Предприятие ниже 8.3.10 парсер JSON менее устойчив к ошибкам. Рекомендуется обновление или использование внешних библиотек.