OGP画像は動的生成ではなく静的サムネイル+カテゴリ別フォールバックにした設計判断
著者: ClaudeMix Team |
ブログ記事のOGP画像を、リクエストごとに動的合成するのではなく、記事のサムネイル画像とカテゴリ別フォールバック画像の組み合わせで解決する設計にした。
① やったこと
案1(不採用): workers-og等のライブラリでリクエスト時にJSXからPNGを都度合成し、日本語フォントをCache APIでキャッシュする動的生成の構成を検討した。フォント取得・画像合成という重い処理をリクエストパスに持ち込む案であり、実装はしていない。
案2(採用): 記事に紐づくサムネイル画像のURLをそのままog:imageへ渡し、サムネイルが存在しない記事はカテゴリ別のフォールバック画像URLを返す。画像合成は一切行わず、既存のURL解決だけで完結する。
// app/lib/blog/post-detail/ogpUtils.ts
export function calculateOgpImageUrl(
thumbnailUrl: { lg: string; sm: string } | null,
category: string,
detailSpec: BlogPostDetailSpec,
r2BaseUrl: string,
): string | null {
if (thumbnailUrl) {
return thumbnailUrl.sm;
}
const fallback = getFallbackThumbnailUrl(category, detailSpec);
if (!fallback) return null;
return `${r2BaseUrl}${fallback.sm}`;
}// app/lib/blog/common/getFallbackThumbnailUrl.ts
export function getFallbackThumbnailUrl(
category: string,
spec: ThumbnailMappingSpec,
): { lg: string; sm: string } | null {
const mapping = spec.thumbnail.display.default_mapping;
if (!mapping) {
return null;
}
return mapping[category] || null;
}差分は、OGP画像を「都度作る」か「既にあるものを解決する」かという一点にある。
② 設計判断
- 【優先した価値】: ランタイムでの画像合成コストがゼロになる。フォント取得・レイアウト計算・PNGエンコードといった重い処理がリクエストパスから消える。
- 【犠牲にした価値】: OGP画像の表現力。記事タイトルや投稿日をOGP画像自体に焼き込むような動的な見た目は作れず、サムネイル画像かカテゴリ共通画像のどちらかを選ぶだけになる。
③ 技術的負債
- 【採用した案が抱える負債】:
getFallbackThumbnailUrlはspec.thumbnail.display.default_mappingからcategoryをキーに1件引くだけの実装で、記事ごとの個別性を持たない。サムネイル画像を持たない記事は、同じカテゴリに属する他のすべての記事と同一のOGP画像になる。app/specs/blog/posts-spec.yamlのcategoriesは現在「ガイド」「開発記録」「設計考察」「資料室」の4件で、サムネイル未設定の記事はこの4パターンのいずれかに必ず収束する。限界が来る条件は「同じカテゴリでサムネイル未設定の記事が2件以上SNS上に並んだとき」で、その場合OGP画像だけでは記事を見分けられない。
④ 経営翻訳
展示会のブースで配布するパンフレットの表紙を、来場者ごとにその場で刷り分けるのではなく、あらかじめ用意した専用表紙(ある場合)か、部門共通の表紙(ない場合)のどちらかを配る運用にした。刷版を都度作る手間はなくなったが、専用表紙を用意していない資料は、同じ部門の別の資料と表紙が区別できないまま配られることになる。