Десятое апреля, утро. Бухгалтер закрывает первый квартал 2026 года в 1С. Создаёт документ "Пачка ПУ-3", заполняет, проводит. Открывает форму "Выгрузка ПУ-3", выбирает период "январь — март 2026", нажимает "Заполнить".
Ничего.
Никакой таблицы. Никакого сообщения об ошибке. Курсор поморгал в форме и встал на месте, как будто кнопку никто не нажимал. За весь 2025 год эта же форма работала без единой жалобы. И за 2024-й. И за 2023-й. А в апреле 2026-го перестала.
Самое неприятное в этом баге — то, что он жил в коде с момента написания. Просто несколько лет подряд пользователь случайно обходил его стороной. До того утра, пока не сменил привычку.
Сначала я подумал, что виноваты данные
Подключился к базе, открыл список сотрудников. В первой же строке — страховой номер "1". Не четырнадцатизначный номер, а просто единица. Подозрительно? Конечно. Имеет отношение к проблеме? Спойлер — нет, ни малейшего. Но в первые полчаса я был уверен, что нашёл причину.
Это типичное для отладки явление: первое, что выглядит ненормальным, перетягивает на себя всё внимание. Я начал писать тестовый запрос, чтобы найти всех сотрудников с короткими страховыми номерами, прикидывал, как чинить реквизит. И только когда дошёл до строки в коде, которая обращается к сотрудникам, понял: код туда вообще не доходит. Запрос обрывается раньше — на этапе поиска документов "Пачка ПУ-3".
Страховой номер "1" остался жить в базе. К нему я ещё вернусь, но это будет другая история.
Корневая причина: одно слово в условии запроса
Открыл модуль формы "Выгрузка ПУ-3". Запрос, который подтягивает данные для выгрузки, начинается с поиска самих документов "Пачка ПУ-3" за нужный период. Логично — сначала найти отчётные документы, потом раскрутить из них сотрудников и начисления.
ВЫБРАТЬ
ПачкаПУ3.Ссылка
ИЗ
Документ.ПачкаПУ3 КАК ПачкаПУ3
ГДЕ
ПачкаПУ3.Дата МЕЖДУ &НачалоПериода И &КонецПериода
И ПачкаПУ3.Проведён
Документ "Пачка ПУ-3" хранит две даты. Одна — это поле Дата: момент, когда документ был физически создан и записан. Другая — реквизиты ПериодС и ПериодПо: за какой отчётный квартал этот документ. Это разные сущности. Документ за первый квартал может быть создан и десятого января (заранее, по черновым данным), и тридцать первого марта, и десятого апреля — лишь бы реквизиты периода стояли правильно.
Запрос фильтрует по полю Дата. Не по реквизитам периода.
Параметры передаются с формы: НачалоПериода = 01.01.2026, КонецПериода = 31.03.2026. База послушно ищет документы, у которых поле Дата попадает в этот промежуток. Документ, созданный десятого апреля, в промежуток не попадает. Документ не находится. Запрос возвращает пустую выборку.
Дальше обработчик идёт по пустой выборке, не выдаёт ни одной строки в результат, и тихо выходит. Без сообщения. Без диагностики. Форма выглядит так, будто пользователь ничего не нажимал.
Почему годами никто не жаловался
Это вопрос, который меня зацепил больше, чем сам баг. Если фильтр стоит на неправильном поле, он же должен был ломаться постоянно. У бухгалтера ведь есть свобода — создавать документ когда удобно. Почему он за три года ни разу не создал документ "не тогда"?
Запросил у базы все документы "Пачка ПУ-3" за 2025 год напрямую, минуя форму. Глянул на даты создания.
Все документы за первый квартал 2025-го имели дату 31 марта. Все за второй — 30 июня. Третий — 30 сентября. Четвёртый — 31 декабря. Без единого исключения за весь год.
Стало ясно. Бухгалтер привык закрывать квартал ровно в последний день квартала. Это была её внутренняя дисциплина: "тридцатое число — день отчётности". Документ создавался в этот день, а значит его поле Дата совпадало с последним днём отчётного периода. И случайно попадало в тот промежуток, который форма передавала в запрос.
Запрос искал документы между 1 января и 31 марта. Документ имел дату 31 марта. Условие выполнялось. Документ находился. Форма работала.
Но не потому что код был правильным. А потому что бухгалтер случайно соблюдала неявное правило, о котором никто не знал.
В этом году что-то поменялось в её рутине. Может быть, заболела в конце марта. Может быть, ждала уточнённых данных от отдела кадров. Не знаю и не спрашивал. Знаю одно: она создала документ десятого апреля, и привычка, которая годами прикрывала баг, перестала работать.
Код потерял своё алиби.
Гипотеза, проверенная и подтверждённая
Прежде чем перейти к фиксу, я хочу остановиться на одном поведении, которое сам в себе оттачиваю годами и которое часто отличает аккуратного разработчика от торопливого. Когда видишь "очевидную" проблему в коде — это не повод сразу её править. Это повод проверить, правда ли это та проблема, о которой говорит пользователь.
Хочу подчеркнуть один момент, который для меня важнее самого фикса. Когда я понял, что фильтр стоит на неверном поле, у меня была гипотеза. Чтение кода — это всегда гипотеза. "Кажется, я понял, что тут не так". Но между "я понял" и "я проверил" — пропасть, особенно когда на другой стороне квартальная отчётность в государственный фонд.
Поэтому я не побежал сразу править код. Сделал ещё одну вещь: написал прямой запрос к рабочей базе, который воспроизводит ровно ту же логику, что в форме. Подставил параметры периода. Запустил. Получил пустую выборку.
Потом изменил условие на ПериодС >= &НачалоПериода И ПериодПо <= &КонецПериода. Запустил. Получил конкретный документ — тот самый, который бухгалтер создала десятого апреля и не могла найти.
Только теперь я был уверен. Не "я думаю, что нашёл проблему", а "я воспроизвёл проблему и нашёл условие, которое её снимает". Разница между этими двумя состояниями — это разница между "завтра позвонит бухгалтер" и "вопрос закрыт".
Фикс на две строки
Изменение получилось минимальным. В запросе одна строка условия:
// Было:
ГДЕ ПачкаПУ3.Дата МЕЖДУ &НачалоПериода И &КонецПериода
// Стало:
ГДЕ ПачкаПУ3.ПериодС >= &НачалоПериода
И ПачкаПУ3.ПериодПо <= &КонецПериода
Плюс ещё одно изменение, которое я считаю даже более важным, чем сам фикс. В обработчик "Заполнить" добавил несколько строк:
Если Результат.Количество() = 0 Тогда
Сообщить("За указанный период не найдено ни одного проведённого "
+ "документа Пачка ПУ-3. Проверьте период и наличие документов.");
Возврат;
КонецЕсли;
Это исправление другого, более тихого бага. Форма не должна молчать, если не нашла данных. Пустая таблица в ответ на "Заполнить" — это диагностический ноль для пользователя. Бухгалтер не должен гадать: "Документов нет?", "Я что-то сделала не так?", "Программа сломалась?". Он должен видеть конкретное сообщение, и желательно с подсказкой, что проверить.
Если бы это сообщение было в коде с самого начала — баг нашли бы за день, а не за три года. Не потому что код стал бы правильным, а потому что отсутствие данных перестало бы выглядеть как "норма". Пользователь увидел бы сообщение, удивился, позвонил, и я полез бы разбираться сразу.
Молчаливый код прячет ошибки. Это правило я для себя сформулировал давно, и каждый раз, когда нарушаю его, оно мне об этом напоминает.
Что я взял из этой истории
Если бы меня попросили сформулировать вывод для младшего разработчика, я бы выделил три пункта.
Поля "Дата" и "Период" — разные. В 1С документ почти всегда имеет поле Дата — это момент создания, технический реквизит. И он почти никогда не равен бизнес-смыслу того, что описывает документ. Зарплата за март — это не "документ от 5 апреля". Это "документ за период март". Если в запросе ты фильтруешь зарплату по полю Дата, спроси себя: точно ли это то поле, по которому правильно фильтровать? В девяти случаях из десяти — нет.
"Работает" — не значит "правильно". Этот код работал годами. Тысячи квартальных закрытий. Ни одной жалобы. Ни одного бага в трекере. Идеальный рабочий код по любым внешним признакам. И всё это время в нём был фильтр на неверном поле, который случайно срабатывал благодаря привычке одного конкретного пользователя. Когда привычка изменилась — исчезло и алиби. Я с похожей логикой уже сталкивался и писал об этом в истории про три бага, которые прикрывали друг друга: код был неправильный с момента написания, просто другие баги сглаживали его последствия.
Гипотезу подтверждай запросом. Я мог пойти и поправить запрос сразу, как только увидел условие на Дата. Скорее всего, угадал бы. Но "скорее всего" — это не профессиональный уровень для квартальной отчётности. Воспроизводимый запрос к живой базе — это контракт между "я думаю" и "я знаю". Особенно когда пользователь будет ждать результата отчёта в фонд через час.
И четвёртый, самый общий пункт, который я повторяю себе уже много лет. Молчание — самый опасный режим работы программы. Пустой результат, проглоченное исключение, тихий Возврат в обработчике — всё это создаёт у пользователя ложное ощущение, что система "подумала и решила, что данных нет". А она не думала. Она ничего не нашла, потому что её фильтр сравнивал не те поля, и она не сочла нужным об этом сказать.
Этот баг сидел в коде дольше, чем существуют некоторые проекты, которыми я занимаюсь сегодня. И его нашли не потому что кто-то стал лучше тестировать, и не потому что в линтер добавили правило про реквизиты периодов. Его нашли потому, что бухгалтер однажды нажала "Создать документ" не тридцать первого марта.
В похожем по духу случае я когда-то находил баг с двойной негацией, который проявлялся только при совпадении трёх условий и тоже месяцами не давал о себе знать. Это, кажется, базовое свойство 1С-проектов: чем меньше код общается с пользователем о своих результатах, тем дольше живут самые странные баги.
Код не виноват. Код делает то, что в нём написано. Виновата привычка автора не написать сообщение о пустом результате и не задуматься, по какому полю он фильтрует период. Эту привычку я в себе отрабатываю до сих пор. Семнадцать лет — и всё ещё есть, что в себе чинить.





