
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が効いているのに文字だけおかしいと感じたら、まず「その環境に、その文字を描けるフォントが本当にあるか」を疑うのが近道だ。