困ったとき

デプロイとトラブルシューティング

静的生成したガイドサイトを安全に公開し、起動時のよくあるエラーを切り分けます。

更新 2026-09-04読了 10分

コンテナの状態を確認する

bash
docker compose ps
docker compose logs -f

公開用ファイルを作る

エックスサーバーへはNuxtの静的生成結果を配置します。公開URLを指定してから生成してください。

bash
NUXT_PUBLIC_SITE_URL=https://headless-wp.cakizaki.com npm run generate

生成結果は .output/public/ に作られます。この中には各ガイドページのHTML、robots.txt、sitemap.xml、OGP画像が含まれます。

Nuxtに接続エラーが出る

WordPressの初期設定が完了しているか確認し、http://localhost:8080/wp-json でJSONが表示されるか確認します。

bash
docker compose restart nuxt

データを守る

docker compose down -v はMySQLの保存領域も削除します。原因が分からない段階では実行しないでください。ZIPを別名のフォルダへ展開した場合は、Dockerが別プロジェクトとして扱い、投稿が消えたように見えることがあります。