Ошибка «Итератор для значения не определен» в 1С: причины и способы исправления

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

Проще говоря, конструкция «Для каждого Элемент Из Значение Цикл» работает только с объектами, которые поддерживают итерацию: массивы, таблицы значений, списки значений, выборки из результата запроса, коллекции строк табличных частей и подобные. Если вместо коллекции подставлено число, строка, ссылка на справочник, «Неопределено» или результат функции, вернувшей единичное значение, платформа не может создать итератор и прерывает выполнение с этой ошибкой.

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

Что означает эта ошибка технически

Во встроенном языке 1С цикл «Для каждого» неявно запрашивает у объекта итератор — внутренний механизм последовательного доступа к элементам. Итератор реализован только у объектов-коллекций: массивов, структур (при обходе через соответствующие методы), таблиц значений, выборок запроса, табличных частей, списков значений и ряда других системных коллекций.

У примитивных типов (число, строка, дата, булево), у ссылок на объекты базы данных и у значения «Неопределено» итератора нет. Как только такое значение оказывается справа от «Для каждого … Из», платформа выбрасывает исключение ещё до первой итерации — тело цикла не выполняется ни разу.

Типичные причины возникновения

Чаще всего проблема связана с тем, что функция или метод вернули не то, что ожидал разработчик. Например, метод «Найти» справочника возвращает ссылку или «Неопределено», а не коллекцию; запрос, в котором забыли вызвать «Выбрать()» или «Выгрузить()», не даёт обходимого результата; функция поиска строк таблицы значений вернула одну строку вместо массива.

Вторая группа причин — неинициализированные переменные. Если переменная объявлена, но коллекция в неё не помещена (ветка кода с присваиванием не выполнилась), её значение равно «Неопределено», и цикл по ней падает. Это особенно характерно для кода с условной логикой и обработчиками исключений.

Третья группа — некорректные данные в типовых механизмах. При обмене, синхронизации или проведении документов типовой код ожидает заполненную табличную часть, набор записей или настройку определённого формата. Пустые или повреждённые данные приводят к тому, что внутренний алгоритм получает пустое значение вместо коллекции.

Как найти проблемное место в коде

Первый шаг — получить точный стек вызовов. В окне ошибки 1С обычно указывается модуль и строка, где возникло исключение. Если сообщение недостаточно информативно, включите отладку, поставьте точку останова перед циклом и выполните действие заново.

В отладчике вычислите выражение, стоящее справа от «Из», и посмотрите его тип. Быстрый способ — добавить перед циклом временную проверку через «ТипЗнч()» и вывод в сообщение. Если значение равно «Неопределено», проследите по коду, где оно должно было быть заполнено, и почему присваивание не произошло.

1. 1
   Зафиксируйте действие, при котором возникает ошибка, и текст сообщения с указанием модуля и строки
2. 2
   Откройте конфигуратор, включите отладку и поставьте точку останова на строке цикла
3. 3
   Вычислите выражение справа от «Из» и определите его фактический тип
4. 4
   Найдите место, где это значение формируется, и проверьте условия его заполнения
5. 5
   Исправьте источник значения или добавьте проверку типа перед циклом
6. 6
   Повторите действие и убедитесь, что цикл выполняется корректно

Как исправить ошибку в собственном коде

Основной приём — проверка перед циклом. Если коллекция может быть не получена, оберните обход в условие: убедитесь, что значение не «Неопределено» и имеет ожидаемый тип. Для результатов запроса проверяйте «Пустой()» у результата и корректно вызывайте «Выбрать()» или «Выгрузить()» в зависимости от того, нужна выборка или таблица значений.

Если метод поиска возвращает единичное значение (например, «НайтиСтроки» возвращает массив, а «Найти» — строку или «Неопределено»), используйте правильный метод под задачу. Для обхода подходят «НайтиСтроки», «Выгрузить», «Выбрать»; для работы с одним найденным элементом цикл не нужен вовсе — достаточно проверки на «Неопределено».

Пример безопасного шаблона: сначала получить результат, затем проверить его, и только потом обходить. Это защищает и от текущей ошибки, и от скрытых падений при изменении данных.

РезультатЗапроса = Запрос.Выполнить();
Если Не РезультатЗапроса.Пустой() Тогда
    Выборка = РезультатЗапроса.Выбрать();
    Пока Выборка.Следующий() Цикл
        // обработка строки выборки
    КонецЦикла;
КонецЕсли;

Для коллекций, которые могут быть «Неопределено» по логике прикладного кода, используйте явную проверку:

Если ТаблицаСтрок <> Неопределено Тогда
    Для каждого СтрокаТаблицы Из ТаблицаСтрок Цикл
        // обработка строки
    КонецЦикла;
КонецЕсли;

Если ошибка возникает в типовой конфигурации

Когда ошибка появляется в типовом документе, обмене или отчёте без ваших доработок, сначала проверьте данные. Убедитесь, что заполнены обязательные табличные части, настройки обмена, сопоставления объектов и обязательные реквизиты. Нередко причина — пустая табличная часть там, где алгоритм ожидает хотя бы одну строку, или незаполненная настройка после обновления.

Если в конфигурации есть расширения или доработки, временно отключите их и повторите действие. Значительная часть подобных ошибок после обновлений вызвана расширениями, которые перехватывают типовые обработчики и передают в них значения неподходящего типа.

Профилактика: как не допускать эту ошибку

Формируйте функции так, чтобы они всегда возвращали предсказуемый тип: если функция должна вернуть коллекцию, пусть возвращает пустой массив или пустую таблицу значений вместо «Неопределено». Тогда вызывающий код может безопасно обходить результат без дополнительных проверок.

Используйте строгую проверку результата запроса: «Выполнить()» всегда возвращает результат, но обходить его напрямую нельзя — нужен «Выбрать()» или «Выгрузить()». Помните про различие методов поиска: «Найти» возвращает один элемент, «НайтиСтроки» — массив.

Как проверить, что проблема решена

После исправления повторите исходное действие на тех же данных, где ошибка воспроизводилась. Цикл должен либо корректно отработать по элементам, либо быть осознанно пропущен за счёт проверки — без исключений.

Дополнительно проверьте граничные случаи: пустую табличную часть, отсутствие строк в результате запроса, документ без заполненных необязательных реквизитов. Именно на граничных данных эта ошибка чаще всего возвращается.

Частые вопросы