30秒で判断
- 対応すべき人: Astro +
@astrojs/cloudflareアダプターを使い、Cloudflare Workers(workerd)環境にデプロイしている - 対応不要な人: Astroを使っていない / Cloudflare Workers以外(Node.js・Vercel等)にデプロイしている / @astrojs/cloudflare を使用していない
- 確認コマンド:
npm list @astrojs/cloudflare(またはcat package.json | grep cloudflare)
この変更が意味すること
@astrojs/cloudflare@14.0.2 は、Cloudflare Workers(workerd)環境でAstroのプリレンダリングを使用する際に発生していた深刻なバグを修正しました。
この問題では、プリレンダリング中にページがエラーをスローした場合でも、astro build コマンドが exit 0(正常終了)で終了してしまい、切り詰められた(不完全な)HTMLが出力ファイルとして生成されていました。開発者はビルドが成功したと思い込んだまま不完全なページをデプロイしてしまうリスクがありました。
修正後は、レスポンスボディをworkerd内で完全にバッファリングしてからビルドプロセスに返すことで、ストリーミングエラーが確実に捕捉され、明確なエラーメッセージとともにビルドが失敗として報告されるようになりました。
主な変更点
workerdでのビルドエラーサイレント握りつぶし問題を修正(PR #17049)
変更前: プリレンダリング中のエラーが黙殺され、不完全なHTMLが生成されていた。astro build が exit 0 で完了するため、CI/CDパイプラインがビルド失敗を検知できなかった。
変更後: ビルドプロセスへのレスポンス前にボディを完全バッファリング。ストリーミング途中のエラーも確実に捕捉し、ビルド失敗として扱われる。
依存パッケージの更新
@astrojs/underscore-redirects@1.0.3に更新
EOL / サポート状況
Astro固有のEOLデータは現在追跡対象外です。Astroの最新バージョンは 7.0.4(2026年6月30日時点)です。
| パッケージ | 最新版 | ステータス |
|---|---|---|
| astro | 7.0.4 | ✅ 最新 |
| @astrojs/cloudflare | 14.0.2 | ✅ 最新 |
開発者への影響
- Cloudflare Workers + Astroのビルド信頼性が向上 — これまで静かに失敗していたビルドが正しくエラーとして報告されるようになる
- CI/CD パイプラインの検知精度が改善 — exit codeが正しくなるため、GitHub ActionsやCircle CI等でのビルド失敗検知が機能するようになる
- メジャーバージョン変更に注意 — v13→v14のメジャーバンプのため、
package.jsonの依存指定(^13.x.x等)を更新する必要がある
アップデート方法
# npm の場合
npm install @astrojs/cloudflare@latest
# pnpm の場合
pnpm add @astrojs/cloudflare@latest
# yarn の場合
yarn add @astrojs/cloudflare@latest
アップデート後、Cloudflare Workers環境でのビルドを確認してください。
astro build
データソース: GitHub Releases API, endoflife.date, npm Registry AI解説は Claude API により自動生成されています。正確性については原文をご確認ください。
