Error occurred prerendering page の読み方

読むのは次の行

実機で、ビルドのときに描くページの中で例外を投げると、出力はこう並びました。

Error occurred prerendering page "/about". Read more: https://nextjs.org/docs/messages/prerender-error
Error: cms-timeout                          ← 本当の原因
    at c (app\about\page.tsx:1:31)          ← どのファイルの何行目か
  digest: '3666236157'
Export encountered an error on /about/page: /about, exiting the build.

1行目の文言だけで検索しても、原因は分かりません。ビルドのときにページを描く途中で、何かの例外が起きた、という意味しかないからです。

原因の文言ごとの直し方

実機で確かめた文言です。一緒に出た文言がこのどれかなら、それぞれの記事に直し方があります。

• window / document / localStorage：window・document is not defined の直し方
• useSearchParams：useSearchParams の suspense エラー
• NextRouter：NextRouter was not mounted の直し方
• updateTag：revalidateTag の第2引数と updateTag

自分の読み込みが失敗しているとき

Cookie もクエリ文字列も使っていないページは、ビルドのときに描かれます（キャッシュの解説）。中で呼んだデータの読み込みも、ビルドのときに動きます。

だから、ビルドのときにつながらない相手（止まっている外部のサービス、ビルドする場所から見えないデータベース）から読むページは、ビルドを止めます。

export default async function Page() {
  const body = await load()
  return <p>{body}</p>
}

import { connection } from 'next/server'
 
export default async function Page() {
  await connection()
  const body = await load()
  return <p>{body}</p>
}

実機で、await connection() を足すとビルドが通り、そのページは一覧で ƒ（開かれたときに描く）になりました。

ビルドする場所で確かめる

手元ではビルドが通るのに、CI や Docker の中でだけこのエラーになることがあります。考えられるのは、ビルドする場所から読み込み先に届かないときと、ビルドのときに環境変数が無いときです（環境変数はいつ読まれるのか）。