Как исправить «Ошибка доступа к файлу» при использовании функции КопироватьФайл() в 1С?

При разработке и поддержке конфигураций на платформе 1С:Предприятие разработчики часто сталкиваются с ошибкой: «Ошибка при вызове метода контекста (КопироватьФайл): Ошибка копирования файлов: Ошибка доступа к файлу». Эта проблема может возникнуть внезапно — например, код исправно работал долгое время, но после перехода на клиент-серверный вариант базы или обновления прав доступа операционной системы начал вызывать исключение.

В этой статье мы подробно разберем, почему возникает данная ошибка, как на нее влияет контекст выполнения кода (клиент или сервер), и рассмотрим пошаговые сценарии ее устранения с практическими примерами кода.

Причина 1. Неправильный формат путей (Каталог назначения вместо Файла)

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

Рассмотрим пример неправильного использования функции:

// ОШИБКА: Второй параметр указывает на каталог, а не на конкретный файл
ПутьИсточник = "C:\Users\User\Desktop\От\документ.docx";
ПутьПриемник = "C:\Users\User\Desktop\Тест"; // Это папка!

Попытка
    КопироватьФайл(ПутьИсточник, ПутьПриемник);
Исключение
    Сообщить(ОписаниеОшибки()); // Вызовет ошибку доступа к файлу
КонецПопытки;

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

// ПРАВИЛЬНО: Оба параметра содержат полные пути с именами файлов
ПутьИсточник = "C:\Users\User\Desktop\От\документ.docx";
ПутьПриемник = "C:\Users\User\Desktop\Тест\документ.docx"; // Указали имя файла

Попытка
    КопироватьФайл(ПутьИсточник, ПутьПриемник);
Исключение
    Сообщить(ОписаниеОшибки());
КонецПопытки;

Причина 2. Контекст выполнения (Клиент-Серверное разделение)

Если с путями все в порядке, но ошибка все равно возникает в клиент-серверной базе, дело в контексте выполнения процедуры. Проанализируем, где именно выполняется код — на клиенте или на сервере.

Когда процедура выполняется на сервере (например, в общем модуле с признаком «Сервер» или в серверной функции управляемой формы), платформа выполняет операции от имени операционной системы сервера. При этом возникают две ключевые проблемы:

1. Разные физические машины: Если сервер 1С и ваш персональный компьютер — это разные физические серверы/компьютеры, то путь "C:\Users\User\Desktop..." сервер будет искать на своем локальном диске «C», а вовсе не на вашем рабочем столе. Естественно, такого пути на сервере может не существовать, либо к нему не будет доступа.
2. Права системной службы: Служба сервера 1С:Предприятия (обычно под учетной записью USR1CV8) запускается с ограниченными правами. По умолчанию у этой учетной записи нет прав на чтение и запись в каталоги пользователей Windows (такие как Desktop, Documents и т.д.) даже на самом сервере.

Выясним, как решить проблему с контекстом:

Вариант А. Перенос выполнения на Клиент. Если файлы находятся на локальном компьютере пользователя, операцию копирования необходимо выполнять строго на клиенте. В управляемых формах для этого используется директива &НаКлиенте. В обычных формах убедитесь, что код кнопки не передает управление в серверный модуль до вызова копирования.

&НаКлиенте
Процедура КопироватьФайлНаКлиенте(Команда)
    ПутьИсточник = "C:\Users\User\Desktop\1\Файл_1.docx";
    ПутьПриемник = "C:\Users\User\Desktop\2\Файл_1.docx";
    
    Попытка
        КопироватьФайл(ПутьИсточник, ПутьПриемник);
        ПоказатьПредупреждение(, "Файл успешно скопирован!");
    Исключение
        ВызватьИсключение "Ошибка при копировании: " + КраткоеПредставлениеОшибки(ИнформацияОбОшибке());
    КонецПопытки;
КонецПроцедуры

Вариант Б. Настройка прав службы сервера 1С. Если копирование жизненно важно производить на стороне сервера (например, при регламентном задании), необходимо предоставить учетной записи, под которой запущена служба 1C:Enterprise 8 Server Agent, полные права (Чтение, Запись, Изменение) на исходный и целевой каталоги на сервере.

Причина 3. Копирование по сети (UNC-пути)

Часто файлы копируются внутри локальной сети предприятия (например, из сетевой папки \\SharedFolder\Public\file.xlsx). Если сервер 1С запущен под локальной учетной записью (Local System или локальный USR1CV8), он не сможет выйти в сеть под этими учетными данными и вернет ошибку доступа.

Решением в данном случае является перенастройка службы сервера 1С в операционной системе Windows:

1. Откройте оснастку «Службы» (services.msc).
2. Найдите службу сервера 1С (например, Агент сервера 1С:Предприятия 8.3).
3. Перейдите в свойства службы на вкладку «Вход в систему» (Log On).
4. Переключите переключатель с «С системной учетной записью» на «С учетной записью» и укажите доменного пользователя (например, DOMAIN\1C_Service), у которого есть права доступа к сетевым папкам.
5. Перезапустите службу сервера 1С.

Причина 4. Блокировка файла другими процессами

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

Перед копированием рекомендуется проверять существование файла и обрабатывать возможные блокировки программно:

ПутьИсточник = "C:\Users\User\Desktop\1\Файл_1.docx";
ПроверяемыйФайл = Новый Файл(ПутьИсточник);

Если ПроверяемыйФайл.Существует() Тогда
    Если ПроверяемыйФайл.ПолучитьТолькоЧтение() Тогда
        Сообщить("Предупреждение: Файл открыт в режиме ""Только чтение"". Попытка копирования...");
    КонецЕсли;
    
    Попытка
        КопироватьФайл(ПутьИсточник, "C:\Users\User\Desktop\2\Файл_1.docx");
    Исключение
        Сообщить("Не удалось скопировать файл. Возможно, он занят другой программой. Ошибка: " + ОписаниеОшибки());
    КонецПопытки;
Иначе
    Сообщить("Файл-источник не обнаружен по указанному пути!");
КонецЕсли;

Лучшая практика: Использование временных файлов

Чтобы избежать проблем с правами доступа к системным папкам пользователей на сервере, рекомендуется использовать временные каталоги платформы 1С. Функция ПолучитьИмяВременногоФайла() генерирует уникальный путь в специальном каталоге, к которому у сервера 1С всегда есть гарантированные права доступа.

Посмотрим на пример безопасной работы с временными файлами:

// Получаем уникальное имя временного файла на сервере
ВременныйФайл = ПолучитьИмяВременногоФайла("docx");

Попытка
    // Выполняем промежуточное копирование или создание файла
    КопироватьФайл(ИсходныйПуть, ВременныйФайл);
    
    // Производим необходимые манипуляции с ВременныйФайл...
    
    // После работы обязательно удаляем временный файл
    УдалитьФайлы(ВременныйФайл);
Исключение
    Сообщить("Ошибка при работе с временным файлом: " + ОписаниеОшибки());
    // На всякий случай пытаемся очистить за собой данные в блоке Исключение
    Попытка
        УдалитьФайлы(ВременныйФайл);
    Исключение
    КонецПопытки;
КонецПопытки;

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