メインコンテンツへスキップ
見出し画像

Puppeteerで請求書PDFを作ったら日本語が全部「豆腐」になった話

    見積請求書アプリのPDF出力機能を作っていた。Puppeteerを使ってHeadless ChromeでHTMLをPDFに変換するという、ネット上に大量のサンプルコードがある、一見すると王道の実装方法だ。HTMLテンプレートを準備して、Puppeteerでレンダリングして、PDFで出力。「これなら簡単だ」と思った。本当に簡単だと思った。

    でした。出力されたPDFを開くと、日本語の部分がすべて四角い枠「□」になっていた。請求書としてあってはならない状態だ。この記事では、この「豆腐」の正体と、実際にアプリの中で動いている解決コードをそのまま載せる。

    【つまずき1】「日本語を描画できるフォントが、そもそも無かった」

    豆腐の正体は、日本語の文字の形データ(グリフ)を持つフォントが、PDFを作るHeadless Chromeから使えなかったことだった。描画できるフォントが無いときに出る代替表示が「□」、いわゆる豆腐だ。文字コードの問題ではない。フォントの実体が無い以上、CSSでfont-familyを書いても、指定した先に何も無ければ意味がない。

    【つまずき2】「フォントごとHTMLに埋め込む」

    対処は、Noto Sans JPのフォントファイルをこちらで用意して、HTMLの@font-faceにBase64で直接埋め込むことだった。フォントをData URIとしてCSSの中に入れてしまえば、PDFを作る環境にフォントが入っているかどうかに左右されない。

    アプリでは、public/fontsに置いたNoto Sans JP(RegularとBold、woff2形式)を読み込み、Base64にして@font-face用のCSSを組み立てる関数を1つ用意した。中身はこうなっている。

    const buffer = await readFile(path.join(process.cwd(), "public", "fonts/NotoSansJP-Regular.woff2"));
    const regular = buffer.toString("base64");

    @font-face {
      font-family: "Noto Sans JP";
      font-weight: 400;
      src: url(data:font/woff2;base64,${regular}) format("woff2");
    }

    Boldも同じ形でfont-weight: 700として追加している。この@font-face用のCSSを、PDF用のHTMLに含めてからPuppeteerで出力する。

    【つまずき3】「Base64にすると、サイズが気になる」

    RegularもBoldも、woff2形式で約1MBある。Base64にすると約3割大きくなるので、CSSとしてはかなり大きな文字列になる。毎回読み込むのは無駄なので、最初に一度だけ読み込んで、結果をメモリに保存(キャッシュ)して使い回す作りにした。

    持ち帰り:PDFを作る環境にフォントが入っている前提で作らない。使うフォントは、フォントごと埋め込んで持ち運べる形にしておく。

    フォントを埋め込んだあと、生成したPDFを目視で確認し、日本語が正しく表示されることを確かめた。CSSが効いているのに文字だけおかしいと感じたら、まず「その環境に、その文字を描けるフォントが本当にあるか」を疑うのが近道だ。

     
     
    AIと一緒にアプリやツールを作る個人事業主(屋号:ことぶきや)。Claude Codeと殴り合ってハマった話を、原因と直し方まで包み隠さず書いています。有料記事は再現できるコード付き。

    あなたへのおすすめ