Найдите первую неуспешную операцию для одного ролика: отправка файла, сохранение на сервере, чтение медиаконтейнера или проверка допустимых дорожек. Сохраните код ответа и безопасный идентификатор загрузки. Сообщение «формат не поддерживается» в интерфейсе слишком общее, чтобы сразу назначать конвертацию.
Используйте короткую тестовую запись без личных данных и сохраните оригинал. Не пересылайте её через сервис, который может изменить формат, перед сравнением с серверной копией. Иначе успешная повторная загрузка другого файла скроет первоначальную причину.
Ответ API показывает, дошёл ли файл до обработки
Откройте сетевой запрос в инструментах разработчика браузера и сопоставьте его время с журналом приложения. Если запрос отклонён до создания объекта, исследуйте ограничение загрузки, маршрут и полномочия пользователя. Если объект создан, найдите результат следующего шага по тому же идентификатору.
| Наблюдение | Следующий шаг |
|---|---|
| Нет сохранённого объекта | Запрос и ограничения приёма |
| Объект отличается от оригинала | Передача и фиксация загрузки |
| Данные читаются, профиль отвергнут | Правило допустимых дорожек |
Сверяйте размер и контрольную сумму оригинала с сохранённым объектом там, где это доступно в вашем приложении. Совпадение имени не означает совпадение содержимого. Неполный объект или отсутствующий хвост требуют исправления передачи и завершения загрузки, а изменение видеокодека здесь не устраняет причину.
Условный интерфейс показывает прогресс до конца, но сервер затем отвергает медиаданные. Разделите отображаемые состояния «передано», «проверяется» и «принято». Пользователь должен получить итог проверки, а повтор запроса не должен незаметно создать несколько одинаковых задач конвертации.
Расширение файла не заменяет сведения о дорожках
FFprobe позволяет прочитать формат контейнера и отдельные медиапотоки. Официальная документация проверена 9 ноября 2026 года. Пример ниже читает локальную тестовую копию и выводит JSON; он не меняет исходник и не выполняет конвертацию.
# Проверка локальной тестовой копии
ffprobe -v error -show_format -show_streams -of json phone-test.movИз результата выпишите контейнер, кодеки видео и аудио, размеры кадра и длительность. Затем сравните их с явно записанным контрактом вашего сервиса. Если контейнер читается, но один кодек отсутствует в разрешённом профиле, интерфейс должен сообщить именно это ограничение. Не обещайте поддержку всех роликов по одному расширению MP4 или MOV.
Если probe не открывает объект, сравните его с оригиналом на том же инструменте. Успех на оригинале и отказ на серверной копии возвращают расследование к передаче или хранению. Отказ на обоих экземплярах требует проверки целостности и возможностей конкретной сборки инструмента. Полный диагностический вывод может содержать метаданные съёмки, поэтому перед передачей его очищают.
Приёмка файла и выпуск совместимой копии — разные состояния
Для допустимого входа можно готовить производный профиль, который поддерживают целевые плееры. Сохраните связь с оригиналом и версию профиля. Если обработка не удалась, оставьте понятное состояние ошибки и возможность согласованного повтора; нельзя обозначать загрузку готовой, пока обязательная производная ещё отсутствует.
- Зафиксировать один исходный файл.
- Связать запрос с серверным объектом.
- Сравнить дорожки с контрактом сервиса.
- Принять успешный и ошибочный сценарии повторной загрузки.
Проверьте как минимум обычный разрешённый файл и тот тестовый образец, на котором был отказ. Повторите потерю связи до завершения загрузки и повторное нажатие кнопки. Ожидаемый результат — один понятный объект с известным статусом, а не несколько скрытых копий и одинаковых ошибок.
Передавайте разработчику код ответа, этап отказа, сведения о дорожках и описание целевого профиля. Оригинал нужен только по согласованному каналу, если обезличенных параметров недостаточно. Исправление принято, когда сервис различает сетевой отказ, повреждённый файл и неподдерживаемый профиль, а пользователь понимает дальнейшее действие в каждом случае.