Как отличить занятый File Provider item от общего сбоя Nextcloud: матрица preview и Remove Download без удаления файла и принудительного завершения процессов.
Поймите, что делает Remove Download
Официальная справка Nextcloud описывает macOS Virtual Files как File Provider: локальную копию можно освободить, не удаляя объект на сервере. Apple называет системную операцию eviction удалением содержимого item из локального кэша с переводом materialized item в dataless state. Поэтому неудачный Remove Download не равен удалению файла и не доказывает сбой серверной синхронизации. Перед тестом убедитесь, что у объекта нет несинхронизированных изменений; для файлов с локальными правками Apple прямо допускает отказ eviction.
Поставьте контроль рядом с Quick Look
Выберите два небольших уже загруженных файла одного безопасного типа в одном Nextcloud-домене. Файл A один раз откройте пробелом в Quick Look и закройте preview обычным способом. Файл B не просматривайте. Затем по одному разу вызовите Remove Download для A и B. В таблице отметьте значок sync до теста, факт preview, текст диалога, успешность действия и время. Не используйте документы с личными данными и не снимайте содержимое: достаточно условных имён A и B и результата операции.
Отделите EBUSY от общего сообщения
Apple указывает EBUSY как один из возможных отказов eviction, когда item занят открытым файловым дескриптором. Но общий диалог о helper application сам по себе не раскрывает код и может сопровождать разные причины. Называйте наблюдение EBUSY только если этот код действительно присутствует в очищенном системном событии на время теста. Если A и B отказали одинаково, Quick Look не отделён как граница; переходите к общей диагностике File Provider. Если отказал только A, это воспроизводимая preview-граница, но ещё не доказанная корневая причина.
Не применяйте силовые обходы
В публичной ветке упоминается принудительное завершение QuickLookUIService, однако такой шаг не нужен для доказательства пользовательского симптома и может прервать другие preview-задачи. Не выполняйте kill-команды, не сбрасывайте File Provider domain, не выключайте аккаунт и не переустанавливайте Nextcloud. Эти действия меняют сразу несколько переменных и могут оставить несинхронизированные элементы отдельно от ожидаемого места. Безопасный критерий остановки — один контрольный файл, один preview-файл и один результат для каждого.
Соберите минимальный отчёт
Для поддержки укажите версии macOS и Nextcloud Desktop, состояние Virtual Files, тип файлов без имён, две строки матрицы и точное время попыток. Если доступен EBUSY, приложите только очищенную строку события, скрыв пути, домен, имена аккаунтов и идентификаторы документов. Добавьте скриншот диалога без Finder sidebar и содержимого папки. Не публикуйте полный fileprovider dump: он может раскрыть структуру файлов. Исправление подтверждайте только официальным релизом и повтором той же пары A/B после обновления.
Материал подготовлен редакцией VOne с применением ИИ для построения безопасной контрольной матрицы; факты сверены по официальным источникам, а issue использован только как обезличенный сигнал.
Источники и проверка
- Nextcloud User Manual: macOS Virtual Files Client проверено 2026-08-14
- Apple Support: View and edit files with Quick Look on Mac проверено 2026-08-14
- Apple Developer: evictItem проверено 2026-08-14
Информация актуальна на дату публикации. Правила сервисов, приложений и сетей могут меняться.