Администрирование · 12 мин
Как очистить кэш 1С:УНФ
Как очистить кэш 1С:УНФ на клиенте и сервере: удаление папок кэша, параметр /ClearCache, очистка регистров. Признаки устаревшего кэша и типичные ошибки.
Кэш в 1С:Управление нашей фирмой — это служебные данные, которые платформа сохраняет локально, чтобы ускорить запуск и работу базы. Со временем эти данные устаревают или повреждаются, и пользователь сталкивается с типичными симптомами: формы открываются с ошибками, пропадают настройки интерфейса, программа «видит» старую версию конфигурации после обновления, возникают сообщения вида «Ошибка формата потока» или «Поле объекта не обнаружено».
Очистка кэша — штатная и в большинстве случаев безопасная операция: удаляются только временные файлы, а не данные базы. Однако важно понимать, какой именно кэш вы чистите — клиентский (на компьютере пользователя), серверный (на сервере 1С) или кэш метаданных в самой информационной базе. От этого зависит и способ, и риски.
Ниже описаны рабочие способы очистки для файлового и клиент-серверного вариантов УНФ, команды для автоматизации и признаки, по которым можно проверить результат.
Что такое кэш в 1С:УНФ и когда его нужно чистить
Платформа 1С:Предприятие кэширует метаданные конфигурации, скомпилированные модули, настройки форм и служебные данные сеанса. В файловом варианте кэш хранится в профиле пользователя на компьютере, в клиент-серверном — дополнительно на сервере в каталоге srvinfo. Сама УНФ как конфигурация использует те же механизмы платформы, поэтому способы очистки для неё стандартные.
Чистить кэш «на всякий случай» не обязательно — после удаления первый запуск базы занимает заметно больше времени, потому что платформа формирует кэш заново. Операция оправдана при конкретных симптомах.
Появились ли ошибки сразу после обновления конфигурации
Возникает ли ошибка у одного пользователя или у всех
Помогает ли перезапуск программы
Если проблема у одного пользователя — почти наверняка локальный кэш
Простой диагностический приём: если ошибка воспроизводится только у одного пользователя или на одном компьютере, а у остальных база работает нормально — проблема почти наверняка в локальном кэше. Если ошибка одинакова у всех, искать причину нужно в конфигурации или серверном кэше, а не в папках пользователей.
Подготовка перед очисткой: что обязательно сделать
Перед удалением кэша завершите работу всех сеансов 1С на компьютере, где будет проводиться очистка. Если кэш удалить при запущенной программе, часть файлов окажется заблокированной, а сеанс может завершиться с ошибкой. В клиент-серверном варианте убедитесь, что пользователь не просто свернул окно, а именно закрыл программу.
Хотя очистка кэша не затрагивает данные, перед любыми манипуляциями с базой — особенно если дальше планируется тестирование и исправление — сделайте резервную копию: для файловой базы это копирование файла 1Cv8.1CD или выгрузка через конфигуратор, для клиент-серверной — выгрузка средствами СУБД. Это дешёвая страховка на случай, если причина ошибок окажется не в кэше.
Способ 1. Удаление папок кэша вручную
Самый надёжный способ очистки клиентского кэша — удалить содержимое служебных каталогов платформы. Папки находятся в профиле пользователя Windows. Чтобы быстро попасть в нужный каталог, нажмите Win+R и введите путь с переменной окружения.
Кэш располагается в двух местах: %APPDATA%\1C\1cv8 (роуминговый профиль) и %LOCALAPPDATA%\1C\1cv8 (локальный профиль). Внутри вы увидите папки с длинными именами из букв и цифр — это идентификаторы информационных баз. Каждой базе из списка стартера соответствует своя папка.
- 1Закройте все сеансы 1С:УНФ на компьютере
- 2Нажмите Win+R, введите %APPDATA%\1C\1cv8 и нажмите Enter
- 3Удалите папки с длинными именами (GUID) — это кэш баз
- 4Повторите то же самое для %LOCALAPPDATA%\1C\1cv8
- 5Запустите 1С и войдите в базу — первый запуск займёт больше времени
- 6Проверьте, исчезла ли исходная ошибка
Если баз в списке несколько и вы хотите очистить кэш только одной, папку нужного идентификатора можно найти по файлу ibases.v8i в каталоге %APPDATA%\1C\1CEStart — там перечислены базы и их GUID. Но на практике проще и безопаснее удалить кэш всех баз: он пересоздастся автоматически при следующем запуске.
Обратите внимание: в папке %APPDATA%\1C\1cv8 кроме кэша могут лежать служебные файлы журнала регистрации старых версий и шаблоны. Удалять весь каталог 1cv8 целиком допустимо, но аккуратнее — удалять только папки с GUID-именами.
Способ 2. Параметр запуска /ClearCache
Платформа поддерживает штатный параметр командной строки /ClearCache, который очищает кэш клиентского приложения при запуске. Это удобно, когда не хочется искать папки вручную или нужно дать пользователю простую инструкцию.
Чтобы использовать параметр, откройте свойства ярлыка базы в стартере 1С (или создайте отдельный ярлык) и допишите параметр в строку запуска. В конфигураторе параметр указывается через меню «Сервис → Параметры» в поле дополнительных параметров запуска.
"C:\Program Files\1cv8\8.3.22.1750\bin\1cv8.exe" ENTERPRISE /F"D:\Bases\UNF" /N"Иванов" /ClearCacheВажное ограничение: параметр /ClearCache очищает клиентский кэш метаданных, но не всегда устраняет проблемы, связанные с повреждёнными файлами в локальном профиле. Если после запуска с параметром ошибка сохраняется, переходите к ручному удалению папок — это более радикальный и надёжный вариант.
Способ 3. Очистка через удаление базы из списка
Мягкий вариант: удалить базу из списка в окне запуска 1С и добавить её заново. При удалении из списка платформа предложит очистить связанные служебные данные, а при повторном добавлении для базы будет создан новый идентификатор и чистый кэш.
Способ подходит для файловых баз и не требует поиска папок в профиле. Недостаток — придётся заново указать путь к базе и, при необходимости, настройки подключения. Для клиент-серверных баз потребуется повторно ввести имя сервера и имя базы, поэтому запишите их заранее.
Очистка серверного кэша в клиент-серверном варианте
Если УНФ работает в клиент-серверном режиме и ошибки наблюдаются у всех пользователей, потребуется очистить серверный кэш. Он хранится в каталоге srvinfo на сервере агента 1С:Предприятия, во вложенных папках reg_1541 (номер зависит от порта кластера) — это файлы с именами вида 1CV8Clst.lst и каталоги с GUID баз.
Перед очисткой серверного кэша нужно остановить службу «Агент сервера 1С:Предприятия» — при работающей службе файлы заблокированы, а их удаление может нарушить работу кластера. После остановки службы удалите содержимое папки с GUID проблемной базы (не всю папку reg_1541 целиком, если на сервере несколько баз) и запустите службу снова.
После перезапуска службы первый вход пользователей будет медленным — это нормально, сервер заново строит кэш метаданных. Если ошибка сохраняется и после очистки серверного кэша, проблема, скорее всего, не в кэше: проверяйте конфигурацию, расширения и целостность базы.
Очистка кэша внутри самой УНФ: регистры и настройки
Помимо платформенного кэша, в самой конфигурации УНФ есть механизмы, которые накапливают служебные данные: кэшированные значения в константах и регистрах сведений, настройки вариантов отчётов, пользовательские настройки форм. Их очистка выполняется штатными средствами, а не удалением файлов.
Пользовательские настройки форм сбрасываются через меню «Ещё → Установить стандартные настройки» прямо в форме списка или отчёта. Все настройки пользователя можно очистить через раздел администрирования — «Настройки пользователей и прав», где доступна очистка персональных настроек. Это помогает, когда у пользователя «сломался» вид конкретной формы, а платформенный кэш ни при чём.
Как проверить результат и что делать, если не помогло
Признак успешной очистки — исчезновение исходной ошибки и корректное открытие форм. Первый запуск после очистки всегда дольше обычного: платформа пересобирает кэш, это может занять от нескольких секунд до нескольких минут на больших конфигурациях. Это норма, а не признак проблемы.
Как проверить результат
База открывается, формы работают, ошибки нет
Ошибка воспроизводится сразу при входе
Документ или отчёт открывается без сообщений об ошибке
Та же ошибка «Поле объекта не обнаружено»
У всех пользователей база работает одинаково
Ошибка у всех — проблема не в локальном кэше
Если очистка клиентского и серверного кэша не помогла, последовательно проверьте: актуальность релиза платформы (старые версии платформы могут конфликтовать с новыми релизами УНФ), наличие и корректность расширений конфигурации (отключите их временно), целостность базы через «Тестирование и исправление» в конфигураторе. Ошибка формата потока, которая не лечится очисткой кэша, часто указывает на повреждение данных в таблицах служебных настроек.
Частые вопросы
Удалятся ли мои данные при очистке кэша?
Нет. Кэш — это временные служебные файлы платформы, а не данные информационной базы. Документы, справочники, отчёты и настройки учёта хранятся в самой базе и при очистке кэша не затрагиваются. Могут сброситься только локальные параметры вроде размеров окон, которые платформа восстановит по умолчанию.
Как часто нужно чистить кэш 1С:УНФ?
Регламентно — никогда. Очистка кэша нужна только как реакция на конкретные ошибки: после обновления конфигурации, при сообщениях «Ошибка формата потока», «Поле объекта не обнаружено», при сбоях интерфейса у отдельного пользователя. Плановая очистка без причин только замедляет первый запуск базы.
Ошибка только у одного пользователя — это точно кэш?
С высокой вероятностью — да, если у остальных пользователей та же операция выполняется без ошибок. Начните с очистки локального кэша на его компьютере. Если не поможет, проверьте версию платформы на этом ПК — она должна совпадать с версией на других рабочих местах.
Поможет ли очистка кэша при ошибке «Ошибка формата потока»?
Часто помогает, потому что эта ошибка нередко возникает из-за повреждённых файлов кэша. Но если после полного удаления папок кэша ошибка сохраняется, причина, скорее всего, в повреждении служебных таблиц базы — тогда нужны «Тестирование и исправление» в конфигураторе или очистка таблиц хранения настроек.
Нужно ли чистить кэш после каждого обновления УНФ?
Нет, платформа при обновлении конфигурации сама пересоздаёт необходимые данные. Очистка требуется только если после обновления появились ошибки вида «Метод объекта не обнаружен» или формы открываются некорректно. В этом случае сначала чистят клиентский кэш, затем при необходимости серверный.
Чем отличается /ClearCache от удаления папок кэша?
Параметр /ClearCache очищает кэш метаданных штатными средствами платформы при запуске — это быстро и удобно. Ручное удаление папок в %APPDATA% и %LOCALAPPDATA% удаляет весь локальный кэш целиком, включая повреждённые файлы, которые штатный механизм может не затронуть. При стойких ошибках ручное удаление надёжнее.
Что важно запомнить
Очистка кэша 1С:УНФ безопасна для данных и решает большинство ошибок после обновлений и сбоев интерфейса. Базовый способ — удаление папок кэша в %APPDATA%\1C\1cv8 и %LOCALAPPDATA%\1C\1cv8 при закрытой программе. Если ошибка у всех пользователей, чистите серверный кэш с остановкой агента сервера. Если очистка не помогла — причина не в кэше, проверяйте платформу, расширения и целостность базы.