Base64 から PDF・ファイルに変換（PDF → Base64 も対応）

Base64 PDF 変換 — すぐわかる答え

Base64 PDF とは？

%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

主な機能

Python・Java・JavaScript などで Base64 を PDF に変換

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…

注意：これは 16 進数のようです。16 進数として読むと PDF です。［16 進数としてデコード］

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」に切り替えてファイルをドロップします。

Base64 から変換した PDF が開けない：よくある間違い

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 で返してくる

請求書、電子署名、送り状印刷などの API は、書類を JSON に入れて返すことがよくあります。保存処理のコードを書く前に、レスポンスを貼り付けて中身の書類を確認できます。

開けない PDF のデバッグ

保存したファイルが真っ白、または壊れていると言われたら、同じ Base64 をここに貼り付けてください。途中で切れている、二重エンコードされている、そもそも PDF ではない、あるいは問題なし、のどれかがわかります。問題なしなら、原因はファイルを書き出すコードの側です。

JSON リクエストでファイルを送る

多くのアップロード API は {"filename": …, "content": "<base64>"} の形式を求めます。ここでファイルをエンコードして、Postman や cURL 用のテストリクエストを組み立てられます。

HTML・CSS・メールにファイルを埋め込む

インラインの PDF リンク、フォント、小さな画像用の data URI や、MIME メールのパート用に 76 文字で改行した Base64 を作成できます。

ログやデータベースから添付ファイルを取り出す

テキスト列に保存されたファイルやログに出力されたファイルを、そのまま元に戻せます。%%EOF がないと表示されたら、列やログの行が短すぎて切れていたということです。

Base64 によるファイルエンコードの仕組み

Base64 が 33% 大きくなる理由

1 文字が運べるのは 6 ビットなので、3 バイト（24 ビット）には 4 文字が必要です。パディング込みの長さは 4 × ⌈n ÷ 3⌉ で、100 KB（102,400 バイト）は 136,536 文字になります。MIME 形式では 76 文字ごとに CRLF が入るため、1 MB は 1,398,104 文字ではなく 1,434,896 文字になります。

標準アルファベットと URL セーフアルファベット

RFC 4648 は、最後の 2 文字だけが異なる 2 つのアルファベットを定義しています。+ /（標準、4 章）と - _（URL・ファイル名セーフ、5 章）です。URL セーフな Base64 は通常 = パディングを省略します。1 つの文字列に両方が混ざっている場合、編集されたか連結されたものです。

パディングとあり得ない長さ

= パディングは長さを 4 の倍数にそろえるためのものです。パディングがない場合、4 で割った余りが 2 か 3 なら復元できますが、余り 1 は正しい Base64 では起こり得ません。コピー時に 1 文字欠けたか増えたということです。途中に = がある場合は、たいてい 2 つの文字列が連結されています。

形式はマジックバイトで決まる

ファイルは先頭のバイトで自分の形式を示します。PDF は %PDF-、PNG は 89 50 4E 47、DOCX や XLSX などの ZIP ベースの形式は 50 4B 03 04 です。これらのバイトが Base64 の先頭文字を決めるので、デコードする前に形式を読み取れます。ツール内の対応表を参照してください。

途中で切れた PDF の見分け方

PDF は %%EOF で終わります。末尾 1,024 バイトの中にそれが見つからなければ、ファイルはほぼ確実に途中で切れています。ヘッダーは先頭から 1,024 バイト以内のどこかで始まってもよく、ほとんどのビューアはそのようなファイルも開けるため、報告はしますが拒否はしません。

ファイルを Base64 で送るときのベストプラクティス

MIME タイプとファイル名をデータと一緒に送る

Base64 自体には名前も形式も含まれません。両方を横に並べる（{"filename": "invoice.pdf", "mime": "application/pdf", "content": "…"}）か、data URI を使えば、受信側が推測する必要がなくなります。

受信側でマジックバイトを確認する

保存する前に、デコード結果が %PDF- で始まるかを確かめてください。フィールドの取り違え、二重エンコード、Base64 化されたエラーページを、1 行のコードで検出できます。

大きなファイルは multipart か URL で

Base64 はサイズを 3 分の 1 増やし、文字列全体をメモリに載せる必要があります。数 MB を超えるなら、multipart/form-data や署名付きダウンロード URL のほうが送信側・受信側ともに軽くなります。

データベースには Base64 ではなくバイト列を保存する

BLOB/bytea 列なら 3 分の 1 小さく、VARCHAR のように黙って切り詰められることもありません。Base64 へのエンコードは API の境界でだけ行いましょう。

Base64 PDF 変換 — よくある質問