Как проверить загрузку файла на сайт: тип, размер и ошибки

Проверка загрузки файла включает выбор, передачу, серверную обработку и доступ к результату. Сверьте тип и размер, проверьте отказы и повторную отправку.

Что должно получиться

Разрешённый файл прикрепляется к нужному материалу, сохраняется без повреждения и доступен тем, кому положено его видеть. Неподходящий файл отклоняется с понятной причиной. Человек понимает, нужно ли выбрать другой документ, уменьшить размер или повторить передачу после сбоя.

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

Из чего это складывается

Сначала договоритесь о правилах

До проверки запишите разрешённые форматы, предел размера, количество файлов и права доступа. Уточните, можно ли заменять вложение, кто видит результат и что происходит с файлом после удаления записи. Если эти решения не приняты, одинаковое поведение нельзя уверенно назвать ошибкой или нормой.

Не подставляйте произвольный предел из чужого сервиса. Для своего проекта его выбирают по задаче и возможностям обработки, затем согласуют ограничения интерфейса и сервера. В подсказке должны быть именно действующие правила, а не значения из старого макета.

Как это сделать по шагам

1. Составьте правила приёма и таблицу ожидаемых результатов. Подготовьте безопасные тестовые файлы без личных данных: разрешённый, неподходящего формата, пустой и варианты около установленного предела.
2. Проверьте выбор одного файла, отмену и замену другим. Если разрешено несколько вложений, оцените список, удаление отдельной позиции и подсчёт количества.
3. Сопоставьте браузерные подсказки с серверными правилами. Убедитесь, что неверный файл не принимается только потому, что его удалось выбрать.
4. Проверьте передачу и ожидание. Попробуйте отмену и повтор после обычного сетевого сбоя в тестовой среде, не создавая нагрузку на рабочий сайт.
5. Проверьте серверный результат: сохранённый файл, запись о вложении, состояние обработки и доступ к просмотру. Сравните содержимое с тем, что отправили.
6. Повторите сценарий с неподходящим типом и размером, а также без необходимого права загрузки. Отказ должен быть понятным и не оставлять доступное посторонним вложение.
7. После ошибки исправьте только проблемный файл и завершите форму. Убедитесь, что остальные допустимые данные сохранились, а повторная попытка не создала случайный дубль.
8. Запишите найденные дефекты с этапом, условиями и ожидаемым результатом. После исправления повторите ошибочный случай и загрузите разрешённый файл обычным способом.

Что делает accept

У поля input с type='file' атрибут accept помогает браузеру предложить подходящие типы. Например, для учебной формы изображений список может содержать .jpg,.jpeg,.png. Это пример описания форматов, а не готовая политика для любого проекта.

Accept не проверяет безопасность файла и не заменяет серверную проверку. Человек или клиентское приложение могут передать другое содержимое. Поэтому подсказка выбора нужна для удобства, а решение о приёме принимает сервер по согласованным правилам.

Имя, расширение и содержимое

Расширение — часть имени, а не доказательство формата. Безопасный текстовый файл, переименованный в изображение, не становится изображением. Такой простой тест в собственной тестовой копии помогает увидеть, принимает ли система решение только по окончанию имени.

Сообщённому клиентом Content-Type также нельзя доверять как единственной проверке. Сервер сопоставляет разрешённый тип с содержимым и правилами его обработки. Проверка сигнатуры полезна, но сама по себе не доказывает, что весь файл допустим и безопасен.

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

Размер и пограничные случаи

Проверьте файл немного меньше установленного предела, ровно на нём и немного больше. При этом заранее согласуйте, как измеряется предел и к чему относится: одному файлу, сумме вложений или всей передаче. Подпись в форме должна соответствовать этому смыслу.

У прокси, веб-сервера и приложения могут действовать разные ограничения. Если передача обрывается раньше обработчика, обычное сообщение формы может не появиться. Найдите этап отказа и проверьте, как он представлен человеку. Увеличение одного предела не означает согласованной настройки всей цепочки.

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

Передача, повтор и привязка

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

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

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

Хранение и доступ

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

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

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

Частые ошибки

Показывать миниатюру как окончательное подтверждение

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

Скрывать причину отказа

Общее сообщение о неудаче не помогает, когда нарушено понятное правило типа или размера. Сообщите, что можно исправить. Технические пути сервера и внутренние подробности оставьте в контролируемой диагностике, а не в публичном тексте ошибки.

Проверять только перетаскивание мышью

Если есть область перетаскивания, оставьте доступный способ выбрать файл с клавиатуры и на телефоне. Проверьте подпись поля, фокус и объявление результата. Декоративная зона не должна стать единственным способом прикрепления.

Забывать временные и непривязанные файлы

Проверьте отмену формы, истечение времени и удаление вложения до сохранения. Временный файл не должен оставаться бессрочно доступным или занимать место без предусмотренной очистки. При удалении записи отдельно учитывайте действующие правила хранения и резервных копий.

Как проверить

• Разрешённые типы, предел размера и количество описаны и согласованы между интерфейсом и сервером.
• Выбор, отмена и замена файла не оставляют ложного состояния.
• Неверный тип отклоняется независимо от браузерной подсказки.
• Граница размера проверена с обеих сторон.
• После сетевого сбоя есть понятное продолжение или повтор.
• Успех означает именно предусмотренное завершение обработки.
• Повторная попытка не создаёт случайных дублей.
• После повторного открытия записи доступно нужное вложение.
• Закрытый файл не выдаётся постороннему пользователю.
• Ошибки остальных полей не стирают допустимые данные без объяснения.

Для соседних проверок используйте проверку отправки формы, подписи и сообщения об ошибках и состояния действия. Задачу по обработке вложений можно разместить в разделе «Разработка».

Вопросы и ответы

Файл выбран — значит, он уже на сервере?

Нет. Выбор, передача и сохранение — разные этапы. Проверьте завершение обработки и повторное открытие записи с вложением.

Достаточно ли accept для ограничения форматов?

Нет. Он помогает выбирать файл. Сервер должен независимо проверить его допустимость. Правила приёма нужно применять независимо от поведения браузера.

Почему имя заканчивается правильно, а файл отклоняется?

Расширение не подтверждает содержимое. Сервер может обнаружить другой формат, повреждение или несоответствие правилам обработки.

Нужно ли проверять файл ровно на пределе?

Да. Вместе с вариантами чуть меньше и чуть больше это помогает увидеть, соответствует ли фактическая граница описанному правилу.

Почему передача закончилась, а файл ещё не готов?

После передачи могут продолжаться проверка и создание производных файлов. Интерфейс должен различать эти состояния и показывать действительный результат.

Можно ли считать сложный адрес защитой документа?

Нет. Если файл закрытый, выдача должна проверять полномочия. Не полагайтесь только на трудность угадывания ссылки.

Какие данные приложить к описанию ошибки?

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