調査依頼: Feed静的生成の調査

背景

• B-154の#9: feed系ルートが動的実行されており、GETごとに生成でTTFBがキャッシュ状態依存
• B-127（RSSフィードの静的生成最適化）も関連
• 対象ファイル: src/app/feed*/route.ts, src/app/memos/feed*/route.ts

調査内容

1. 現在のfeedルートの実装を確認する（src/app/feed*/route.ts, src/app/memos/feed*/route.ts）
2. Next.js App RouterでRoute Handlerを静的生成（ビルド時生成）する方法を調査する
3. 既存のfeed実装が動的になっている理由を特定する（dynamic関数の使用、動的APIの使用等）
4. 静的生成に切り替えるための具体的な変更内容を特定する

報告形式

• 現在のfeed実装の概要
• 動的になっている原因
• 静的生成への切り替え方法
• 注意点やリスク

Feed静的生成の調査レポート

調査対象ファイル

• /src/app/feed/route.ts - RSSフィード
• /src/app/feed/atom/route.ts - Atomフィード
• /src/app/memos/feed/route.ts - メモRSSフィード
• /src/app/memos/feed/atom/route.ts - メモAtomフィード

現在のfeed実装の概要

実装構成

4つのRoute HandlerはすべてGETのみをexportしており、シンプルな構成。

// src/app/feed/route.ts（他3ファイルも同様の構成）
import { NextResponse } from "next/server";
import { buildFeed } from "@/lib/feed";

export async function GET() {
  const feed = buildFeed();
  return new NextResponse(feed.rss2(), {
    headers: {
      "Content-Type": "application/rss+xml; charset=utf-8",
      "Cache-Control": "public, max-age=3600, s-maxage=3600",
    },
  });
}

Cache-Controlヘッダー（public, max-age=3600, s-maxage=3600）はHTTPレスポンスヘッダーとして設定されているが、これはNext.jsのFull Route Cacheとは別のCDN/ブラウザキャッシュ設定に過ぎない。

フィード生成ロジック

• buildFeed() (src/lib/feed.ts): ブログ記事を読んでRSS/Atom形式に変換
• buildMemoFeed() (src/lib/feed-memos.ts): メモインデックスを読んでRSS/Atom形式に変換

動的になっている原因

原因1: Next.js 15以降のデフォルト変更（最大の原因）

プロジェクトはNext.js 16.1.6を使用。Next.js 15 RC以降、GETハンドラのデフォルトキャッシュ動作が「静的」から「動的」に変更された。

公式ドキュメント（route.js Version History）より：

v15.0.0-RC: The default caching for GET handlers was changed from static to dynamic

つまり、Route Handlerで明示的にexport const dynamic = 'force-static'を宣言しない限り、GETハンドラはデフォルトで動的実行となる。現在の4つのfeed route.tsにはこの宣言が存在しない。

原因2: feed-memos.tsでのDate.now()の使用

src/lib/feed-memos.tsの40行目でDate.now()を使用している：

const cutoffDate = new Date(
  Date.now() - MEMO_FEED_DAYS * 24 * 60 * 60 * 1000,
);

これは「過去7日間のメモのみを含める」という動的フィルタリングのロジックで、Date.now()はリクエスト時の現在時刻を返す非決定的操作。

Next.jsのドキュメントでは、Cache Componentsが有効な場合、Math.random()のような非決定的操作はプリレンダリングを停止させると明示されている。従来モードでも、これは意図的な動的要素として機能する。

原因3: new Date()の使用

src/lib/feed.tsとsrc/lib/feed-memos.tsの両方でnew Date()を使用：

// feed.ts
const latestDate = posts.length > 0 ? new Date(posts[0].published_at) : new Date();
copyright: `All rights reserved ${new Date().getFullYear()}, ${SITE_NAME}`,

// feed-memos.ts
const latestDate = recentMemos.length > 0 ? new Date(recentMemos[0].created_at) : new Date();
copyright: `All rights reserved ${new Date().getFullYear()}, ${SITE_NAME}`,

これらも現在時刻に依存する非決定的操作だが、実質的にはビルド時に固定値になるため、force-staticを使うと問題なく処理される。

原因まとめ（優先度順）

1. export const dynamicの設定がない（Next.js 15以降はデフォルト動的）← 主因
2. Date.now()でメモのフィルタリングを行っている（memos feedのみ）← 静的化の設計上の障壁
3. new Date()でのcopyrightとlatestDate生成（両feed）← force-staticで解決可能

ビルド確認

.next/prerender-manifest.jsonを確認したところ、/feedと/memos/feedおよび関連ルートは静的プリレンダリングに含まれていない（静的HTMLや.rscファイルが生成されていない）。これにより、毎リクエストごとにサーバーで生成されていることが確認できた。

静的生成への切り替え方法

ブログfeed（feed/route.ts, feed/atom/route.ts）

これらはDate.now()を使っていないため、比較的シンプルに静的化できる。

変更方法:

// src/app/feed/route.ts
import { NextResponse } from "next/server";
import { buildFeed } from "@/lib/feed";

export const dynamic = 'force-static';

export async function GET() {
  const feed = buildFeed();
  return new NextResponse(feed.rss2(), {
    headers: {
      "Content-Type": "application/rss+xml; charset=utf-8",
      "Cache-Control": "public, max-age=3600, s-maxage=3600",
    },
  });
}

同様にfeed/atom/route.tsにもexport const dynamic = 'force-static'を追加する。

メモfeed（memos/feed/route.ts, memos/feed/atom/route.ts）の問題

buildMemoFeed()はDate.now()で過去7日間のメモをフィルタリングするため、単純にforce-staticにするとビルド時の時刻でフィルタリングが固定される問題がある。

例えばビルドが月曜日に行われた場合、その時点での「過去7日間」がずっとキャッシュされ、新しいメモが追加されてもフィードに反映されない。

選択肢：

オプションA: 動的のまま維持（現状維持）

メモフィードは動的のままにして、毎リクエストごとに生成する。ブログfeedのみ静的化する。

オプションB: revalidate設定（ISRアプローチ）

完全静的ではなく、定期的に再生成する方式：

export const revalidate = 3600; // 1時間ごとに再生成

この場合、最初のリクエストで生成され、その後は3600秒ごとに再生成される（ただし動的なアクセスは必要）。

オプションC: フィルタリングを廃止してすべてのメモを含める

Date.now()によるフィルタリングをやめて、最大件数のみで制限する方式に変更すればforce-staticが適用できる。ただし「過去7日間のみ」というフィードの仕様が変わる。

注意点・リスク

1. ブログfeedの静的化は低リスク: ブログ記事はビルド時に静的に取得されるため、force-static追加だけで問題なく動作する。新記事の反映には再ビルドが必要になる（既存の動作と同じ）。

2. メモfeedの静的化は設計変更が必要: Date.now()によるフィルタリングが設計上の障壁。単純なforce-static追加では「過去7日間」フィルタがビルド時点で固定される問題が生じる。

3. Cache-Controlヘッダーとの関係: 現在のCache-Control: public, max-age=3600はHTTPレベルのCDN/ブラウザキャッシュ設定で、Next.jsの静的/動的生成とは独立。静的生成に切り替えても、このヘッダーは引き続き有効。ただし静的生成後はCDNがコンテンツをキャッシュするため、実質的な効果は向上する。

4. revalidateとの組み合わせ: force-staticとrevalidate = Nを組み合わせることで、ビルド時に静的生成しつつ定期的に再生成するISR（Incremental Static Regeneration）の動作も可能。ただし完全な静的ビルド（hosting環境による）では使えない場合がある。

5. テストへの影響なし: 既存のテストはroute.tsのGET関数を直接呼び出すため、export const dynamicの追加はテストに影響しない。

参考情報

• Next.js公式ドキュメント: Route Handlers Caching - https://nextjs.org/docs/app/getting-started/route-handlers
• Route Segment Config reference - https://nextjs.org/docs/app/api-reference/file-conventions/route-segment-config
• route.js Version History - https://nextjs.org/docs/app/api-reference/file-conventions/route