Nuxt SSGビルドエラーを3つ潰して本番デプロイを復旧した

本番サイトを開いたら、2月22日以降の記事がごっそり消えていた。ブラウザのキャッシュかと思いシークレットモードで確認しても同じ。devサーバーでは全記事が表示されているのに、Cloudflare Pagesにデプロイされた本番だけがおかしい。ログを追い始めたら、原因が3つ重なっていた。

原因1: importパスの階層が1段足りなかった

tax-patterns/ 配下の4つのVueファイル（curated.vue, index.vue, quiz.vue, voucher-demo.vue）で、internal/data/extracted/ への相対importパスが1階層不足していた。

// NG: 4階層では届かない
import { ... } from '../../../../internal/data/extracted/curated-200'

// OK: 5階層必要
import { ... } from '../../../../../internal/data/extracted/curated-200'

pages/tax-patterns/curated.vue から internal/ に到達するには pages/ → app/ → web/ → apps/ → root/ の5段登る必要がある。4段だとViteがモジュールを解決できず、ビルドがそこで止まる。

この1つのエラーがViteのビルドプロセス全体を壊し、全ページのSSG生成が中断されていた。devサーバーではHMRが個別にモジュールを解決するため問題が表面化せず、本番ビルド時にだけ爆発するという厄介なパターンだった。

原因2: BlogCalendar.vueのDate型問題

BlogCalendar.vue の getDisplayDate() が、z.coerce.date() で返ってくるDate型オブジェクトを文字列として .split('T') していた。

// 修正後: String()でDate→文字列に変換してからsplit
const getDisplayDate = (article: Article): string | null => {
  const date = article.updatedAt || article.publishedAt
  if (!date) return null
  return String(date).split('T')[0]
}

content.config.ts で publishedAt: z.coerce.date() と定義しているため、ランタイムでは Date オブジェクトが返る。Date.prototype.split は存在しないので、カレンダー表示がクラッシュしていた。String() でラップすることで toISOString() 相当の文字列に変換してから split('T') する形に修正。

Nuxt SSGビルドエラーを3つ潰して本番デプロイを復旧した

原因1: importパスの階層が1段足りなかった

原因2: BlogCalendar.vueのDate型問題

原因3: 未コミットのコンテンツが本番に含まれていなかった

付随して修正したもの

make-diaryスキルのドキュメント改善

content-managementスキルのcategory表にdiaryが欠落

前日の日記の404問題

振り返り