Проследите один разрешённый файл с кириллицей через четыре значения: отображаемое имя, ключ хранилища, локальный путь обработчика и URL выдачи. Они не обязаны совпадать, но связь должна быть однозначной. Если байты успешно сохранены, а задача ищет другой путь, переустановка графической библиотеки не устранит потерянное преобразование имени.

Удобнее хранить объект под контролируемым внутренним ключом, оставляя исходное имя отдельным атрибутом для интерфейса. Это уменьшает зависимость обработки от пользовательского текста. Но само по себе не чинит старые ссылки и не заменяет проверку содержимого файла. Переименование всех объектов без карты соответствия способно разорвать каталог и кеши.

Найдите границу первого расхождения

ГраницаЧто сравнить
Браузер — серверПолученное имя и фактический объект
Сервер — очередьКлюч объекта вместо восстановленного имени
Очередь — локальный файлТочный существующий путь и рабочий каталог
Файл — публичная ссылкаКорректную сериализацию компонента URL
Повтор задачиТот же ключ и версию объекта

RFC 3987 описывает международные идентификаторы IRI и их отображение в URI; источник проверен 22 октября 2026 года. Это не правило кодировки локальной файловой системы. Поэтому не применяйте одно преобразование «для кириллицы» ко всем значениям подряд: URL, имя в интерфейсе и аргумент процесса имеют разные контракты.

Процент и пробел проверяют больше, чем одна русская буква

Условный набор имён для теста:
фото.jpg
фото товара.jpg
фото%товара.jpg
photo.jpg
Для каждого: загрузка -> ключ -> задача -> результат -> URL
Повтор URL-сериализации не должен менять идентичность объекта
Имя пользователя не становится командой оболочки

Собирайте URL библиотекой по правилам его компонентов. Повторное кодирование уже подготовленного адреса может превратить знак процента в другую последовательность. Декодирование всей строки без понимания границ тоже опасно: разделители пути и параметры имеют свой смысл. Сравнивайте ключ объекта с тем, который после разбора действительно запрашивается у хранилища.

Для вызова обработчика передавайте аргументы через безопасный API запуска процесса, без склейки команды из имени пользователя. Кавычки в строке оболочки не являются универсальным исправлением кириллицы и специальных символов. Пути берутся из проверенной серверной записи; обход каталогов и выбор произвольного файла не должны становиться допустимыми побочными эффектами ремонта.

Не теряйте старые ссылки при смене схемы

  1. Подготовить карту старого объекта и нового внутреннего ключа.
  2. Проверить точное совпадение содержимого и принадлежность проекту.
  3. Переключить обработку на ключ, сохранив отображаемое имя.
  4. Проверить каталог, повтор задачи и разрешённые старые ссылки.
  5. Отдельно разобрать коллизии и неоднозначные записи.

Если два имени после выбранной нормализации превращаются в одно, не перезаписывайте файл молча. Внутренний ключ должен исключать такой конфликт, а отображаемое имя может повторяться. Журналируйте техническую связь и причину ошибки без публикации приватных путей и пользовательских данных. Локализованное сообщение «не найден файл» должно вести к конкретной проверке.

Для воспроизведения достаточно искусственных имён, небольшого тестового изображения и журнала переходов между четырьмя представлениями. Смена locale или массовая транслитерация без установленной причины может затронуть другие задачи сервера. Исправляйте найденную границу и сохраняйте совместимость старого реестра, вместо того чтобы запрещать все русские имена.

Проверенные источники