После обновления macOS программа может потерять доступ к файлам из-за изменения privacy-разрешений, sandbox-ограничений, Full Disk Access, устаревших путей или некорректно сохраненных file bookmarks.
Сначала проверьте, пропал ли доступ ко всем файлам или только к конкретным папкам: Desktop, Documents, Downloads, внешнему диску или сетевому каталогу.
Коротко: что делать
- Проверить System Settings > Privacy & Security
- Проверить Full Disk Access и Files and Folders
- Проверить, изменился ли путь к файлу или volume
- Проверить sandbox entitlement приложения
- Посмотреть логи отказа доступа
Основные причины
У этой проблемы редко бывает одна универсальная причина. Обычно нужно проверить связку настроек, данных, кода и внешних сервисов, а потом уже выбирать способ исправления.
- macOS сбросила или изменила privacy-разрешения
- Приложение не запрашивает доступ через правильный диалог
- Старый file bookmark стал недействительным
- Путь к файлу изменился после обновления или миграции
- Sandbox запрещает доступ к папке без entitlement
Пошаговая диагностика
Диагностику лучше вести от конкретного примера: один пользователь, один запрос, один документ, одно событие или один экран. Так проще увидеть точку, где система начинает вести себя неправильно.
- Проверить доступ к тестовому файлу в разных папках
- Посмотреть ошибку: permission denied, operation not permitted, file not found
- Проверить entitlements и подпись приложения
- Проверить, сохраняет ли программа security-scoped bookmark
- Проверить поведение на новом пользователе macOS
Как исправить проблему
Исправление должно закрывать корневую причину, а не только внешний симптом. Если проблема связана с доступами, платежами, данными или безопасностью, сначала стоит сделать резервную копию и проверить правку на тестовом сценарии.
- Добавить корректный запрос доступа к файлу или папке
- Исправить работу с security-scoped bookmarks
- Обновить entitlements и подпись приложения
- Показать пользователю понятную инструкцию для Full Disk Access, если он действительно нужен
- Обработать смену пути и недоступные volume
Безопасный план решения
Не требуйте Full Disk Access без необходимости. Лучше запрашивать доступ только к выбранной пользователем папке и хранить разрешение корректным способом.
Чего не стоит делать
- Не обходить privacy macOS неофициальными способами
- Не просить доступ ко всему диску, если нужна одна папка
- Не считать permission denied обычным file not found
- Не хранить абсолютный путь как единственный признак доступа
Что подготовить перед исправлением
- Версия macOS до и после обновления
- Какая программа и как установлена
- Какие папки недоступны
- Текст ошибки или лог
FAQ
Почему Finder файл видит, а программа нет?
У Finder и приложения разные разрешения. macOS может запретить доступ конкретному приложению.
Нужно ли переустанавливать программу?
Иногда помогает, но лучше сначала проверить privacy-разрешения и логи.
Что такое security-scoped bookmark?
Это способ для sandbox-приложения запомнить разрешенный пользователем доступ к файлу или папке.
Когда стоит обратиться за помощью
Помощь нужна, если приложение рабочее, используется клиентами или требует правильной подписи, sandbox и доступа к документам.
Итог
Начните с privacy-разрешений и точного текста ошибки. Если нужно исправить macOS-приложение, sandbox и доступ к файлам, можно написать в Telegram @rabotator_support.