Как вытащить картинку из MongoDB

Чтобы вытащить картинку из MongoDB, сначала нужно понять, как она хранится. В большинстве проектов в MongoDB хранят не сам файл, а путь или ссылку на изображение. Если картинка хранится как файл внутри базы, обычно используют GridFS. Для маленьких бинарных данных можно встретить поле с байтами, но это не лучший путь для обычных изображений

Три варианта хранения:

путь к файлу: imagePath;
ссылка на CDN или файловое хранилище: imageUrl;
файл в MongoDB через GridFS.

Содержание

Если в документе хранится путь
Если картинка хранится через GridFS
Если в документе лежат байты
Как отдать картинку пользователю
Что лучше выбрать
Как проверить, что достали именно ту картинку
Частые ошибки
Ищут картинку, хотя в базе только путь
Хранят большие файлы прямо в документе
Не задают filename в GridFS
Не закрывают файлы при чтении
Что почитать дальше по MongoDB

Если в документе хранится путь

Пример документа:

{
  title: "Товар",
  imagePath: "/uploads/products/book.jpg"
}

Получение:

const product = db.products.findOne({ title: "Товар" })
product.imagePath

В приложении вы отдаете файл по этому пути или собираете полный адрес

Если картинка хранится через GridFS

GridFS делит файл на части и хранит их в MongoDB. Это удобно для файлов больше обычного BSON-лимита и для случаев, когда нужно хранить файлы прямо в базе

Пример чтения через Python:

from pymongo import MongoClient
import gridfs

client = MongoClient("mongodb://localhost:27017")
db = client["media"]
fs = gridfs.GridFS(db)

file = fs.get_last_version(filename="book.jpg")

with open("book-from-mongo.jpg", "wb") as output:
    output.write(file.read())

После запуска рядом появится файл book-from-mongo.jpg

Если в документе лежат байты

Иногда документ выглядит так:

{
  title: "Аватар",
  image: BinData(...)
}

Такой вариант стоит использовать аккуратно. Для обычных веб-картинок чаще удобнее хранить файл отдельно, а в MongoDB держать ссылку

Как отдать картинку пользователю

Если вы вытащили файл из GridFS, дальше у приложения два варианта. Первый — сохранить файл на диск или в объектное хранилище и вернуть пользователю ссылку. Второй — отдать байты сразу в HTTP-ответе с правильным Content-Type, например image/jpeg или image/png

Для веб-приложения важно не только прочитать картинку, но и правильно назвать файл, указать MIME-тип и не грузить большие изображения целиком в память без необходимости. Если картинок много, добавьте миниатюры: в MongoDB храните ссылку на оригинал и ссылку на уменьшенную версию для карточек

Что лучше выбрать

Для сайта или интернет-магазина обычно лучше хранить изображения в файловом хранилище, а в MongoDB сохранять путь, ссылку, размер, alt-текст и id владельца

GridFS подходит, если файлы должны жить именно в MongoDB или нужно хранить их вместе с базовой инфраструктурой

Как проверить, что достали именно ту картинку

Проверьте не только имя файла, но и размер:

print(file.filename)
print(file.length)

После записи на диск откройте файл вручную или сравните размер с исходным изображением. Если файл появился, но не открывается, чаще всего вы записали не байты картинки, а строку, объект курсора или пустой результат. В GridFS также удобно хранить metadata: id товара, тип изображения, дату загрузки. Тогда поиск будет не только по filename, но и по смысловым полям