Конвертер Base64 в PDF и файлы · PDF в Base64

Base64 в PDF — коротко

Что такое PDF в Base64?

%PDF-1.4          → bytes 25 50 44 46 2D 31 2E 34
JVBERi0xLjQ=      → the same bytes in Base64
data:application/pdf;base64,JVBERi0xLjQ=   → data URI form

Возможности

Base64 в PDF на Python, Java, JavaScript и других языках

Примеры Base64 в PDF

JVBERi0xLjQKMSAwIG9iago8PCAvVHlwZSAvQ2F0YWxvZyAvUGFnZXMgMiAwIFIgPj4K…

PDF · версия 1.4 · скачивается как file.pdf

"data:application\/pdf;base64,JVBERi0xLjQK…"

Как прочитано: удалены обрамляющие кавычки → сняты JSON-экранирования → удален префикс data URI (application/pdf)

{"code":0,"data":{"name":"invoice.pdf","file":"JVBERi0xLjQK…"}}

Как прочитано: из JSON взято поле data.file

data:application/pdf;base64,iVBORw0KGgoAAAANSUhEUgAA…

Предупреждение: в data URI указан application/pdf, но по байтам это PNG. Сохранено как file.png

255044462d312e370a…

Предупреждение: похоже на шестнадцатеричную строку — если читать как hex, это PDF. [Декодировать как hex]

Как конвертировать Base64 в PDF

1. 1

   Вставьте Base64 как есть

   Чистый Base64, data:application/pdf;base64,…, строку, скопированную из JSON с экранированием \/, или весь ответ API. Очень длинные строки удобнее не вставлять, а загрузить кнопкой Открыть файл .txt.

2. 2

   Проверьте, как строка прочитана

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

3. 3

   Посмотрите на тип и предупреждения

   Значок показывает тип, определенный по магическим байтам файла. Желтое предупреждение появляется, если это на самом деле не PDF, если data URI указывает неверный тип или если PDF обрывается до %%EOF.

4. 4

   Просмотрите и скачайте

   PDF открывается во встроенном просмотрщике браузера, изображения и текст показываются прямо на странице. При желании переименуйте файл и нажмите Скачать. Для обратного направления переключитесь на PDF / файл → Base64 и перетащите файл.

Почему PDF из Base64 не открывается: типичные ошибки

base64.b64decode(value)  # value = 'data:application/pdf;base64,JVBERi0…'

b64 = value.split(',', 1)[1] if value.startswith('data:') else value
pdf = base64.b64decode(b64)

fs.writeFileSync('out.pdf', Buffer.from(b64, 'base64').toString())

fs.writeFileSync('out.pdf', Buffer.from(b64, 'base64'))

byte[] pdf = Base64.getDecoder().decode(wrapped);  // IllegalArgumentException

byte[] pdf = Base64.getMimeDecoder().decode(wrapped);

base64.b64decode(token_part)  # contains - and _

base64.urlsafe_b64decode(token_part + '=' * (-len(token_part) % 4))

new Blob([atob(b64)], { type: 'application/pdf' })

const bytes = Uint8Array.from(atob(b64), c => c.charCodeAt(0));
new Blob([bytes], { type: 'application/pdf' })

SELECT LENGTH(pdf_b64) FROM docs;  -- 65535: suspiciously round

ALTER TABLE docs MODIFY pdf_b64 LONGTEXT;  -- or store the bytes in a BLOB

Когда нужен перевод Base64 в PDF

API возвращает PDF в Base64

Сервисы выставления счетов, электронной подписи и печати этикеток часто отдают документы внутри JSON. Вставьте ответ и проверьте документ до того, как писать код для его сохранения.

Отладка PDF, который не открывается

Если сохраненный файл пустой или поврежден, вставьте сюда тот же Base64. Инструмент скажет, обрезан ли он, закодирован ли дважды, PDF ли это вообще — или с ним всё в порядке, и тогда ошибка в том, как ваш код записывает файл.

Отправка файла в JSON-запросе

Многие endpoint для загрузки ждут {"filename": …, "content": "<base64>"}. Закодируйте файл здесь и соберите тестовый запрос для Postman или cURL.

Встраивание файла в HTML, CSS или письмо

Получите data URI для встроенной ссылки на PDF, шрифта или небольшого изображения либо Base64 с переносом по 76 символов для MIME-части письма.

Извлечение вложений из логов и баз данных

Файлы, сохраненные в текстовом столбце или выведенные в лог, можно сразу достать обратно, а отсутствие %%EOF подскажет, что столбец или строка лога оказались слишком короткими.

Как устроено кодирование файлов в Base64

Почему Base64 на 33 % больше

Каждый символ несет 6 бит, поэтому 3 байтам (24 бита) нужно 4 символа. Длина с дополнением равна 4 × ⌈n ÷ 3⌉: 100 КБ (102 400 байт) превращаются в 136 536 символов. Перенос MIME добавляет CRLF после каждых 76 символов, поэтому 1 МБ дает 1 434 896 символов вместо 1 398 104.

Стандартный и URL-safe алфавиты

RFC 4648 определяет два алфавита, которые различаются только последними двумя символами: + / (стандартный, раздел 4) и - _ (безопасный для URL и имен файлов, раздел 5). В URL-safe Base64 дополнение = обычно опускают. Если в одной строке встречаются оба варианта, ее правили вручную или склеили.

Дополнение и невозможные длины

Дополнение = делает длину кратной 4. Без него остаток 2 или 3 можно восстановить; остаток 1 невозможен ни для какого корректного Base64 — символ потерялся или добавился лишний. = в середине обычно означает, что две строки склеили.

Тип определяют магические байты

Файл объявляет свой формат в первых байтах: %PDF- у PDF, 89 50 4E 47 у PNG, 50 4B 03 04 у форматов на основе ZIP, таких как DOCX и XLSX. Эти байты задают первые символы Base64, поэтому тип можно прочитать еще до декодирования — см. таблицу в инструменте.

Как обнаруживается обрезанный PDF

PDF заканчивается на %%EOF. Если маркера нет в последних 1 024 байтах, файл почти наверняка обрезан. Заголовок может начинаться со смещением до 1 024 байт; большинство программ такие файлы все же открывают, поэтому это отмечается, но файл не отвергается.

Как правильно передавать файлы в Base64

Передавайте MIME-тип и имя файла вместе с данными

Base64 не несет ни имени, ни типа. Кладите их рядом ({"filename": "invoice.pdf", "mime": "application/pdf", "content": "…"}) или используйте data URI, чтобы получателю не пришлось угадывать.

Проверяйте магические байты на стороне получателя

Перед сохранением убедитесь, что декодированные байты начинаются с %PDF-. Одна строка кода ловит не то поле, двойное кодирование и страницы ошибок, вернувшиеся в виде Base64.

Для больших файлов лучше multipart или ссылка

Base64 увеличивает размер на треть, и вся строка должна поместиться в памяти. Начиная с нескольких мегабайт, multipart/form-data или предподписанная ссылка на скачивание легче для обеих сторон.

Храните в базе байты, а не Base64

Столбец BLOB/bytea на треть меньше, и его нельзя молча обрезать, как VARCHAR. Кодируйте в Base64 только на границе API.

Base64 в PDF — частые вопросы