この変更が意味すること
Astro v6.4.2 がリリースされました。今回のパッチリリースは2件のバグ修正に絞ったアップデートです。
1つ目は pre-6.0 の @astrojs/mdx と Starlight(またはその他のインテグレーション)を組み合わせた際のクラッシュ修正(#16889)。markdown.remarkPlugins・markdown.rehypePlugins・markdown.remarkRehype を設定するインテグレーションと旧バージョンの @astrojs/mdx を同時に使用すると plugins is not iterable エラーでクラッシュする問題が解消されます。Starlight ユーザーで同様の症状が出ている方には直接関係するパッチです。
2つ目は @astrojs/node アダプターを使った SSR 環境での動的ルート 404 バグ修正(#16878)。アルファベット順で先にソートされるプリレンダリング済みの動的ルートが存在する場合に、SSR 動的ルートへのリクエストが誤って 404 を返す問題が修正されています。
Breaking Changes はなく、v6.4.0 または v6.4.1 から安全にアップグレードできます。
主な変更点
バグ修正: pre-6.0 @astrojs/mdx との plugins is not iterable クラッシュ
影響: Astro 6.x + @astrojs/mdx(pre-6.0バージョン)+ Starlight 等のインテグレーション
markdown.remarkPlugins・markdown.rehypePlugins・markdown.remarkRehype のいずれかを設定するインテグレーション(Starlight 等)と、Astro 6.0 以前の @astrojs/mdx を組み合わせて使用した場合に発生していた plugins is not iterable クラッシュを修正しました(#16889)。
Starlight をお使いで Astro 6.x にアップグレード後にクラッシュが発生している場合、このパッチで解消される可能性があります。
バグ修正: SSR動的ルートがアルファベット順先行プリレンダリングルート存在時に404を返す問題
影響: @astrojs/node アダプターを使用した SSR プロジェクト
本番ビルド(@astrojs/node アダプター使用)において、プリレンダリング済みの動的ルート([a_prebuild].astro、prerender=true)が同じ URL パターンを持つ SSR ルート([b_ssr].astro)よりアルファベット順で先にソートされる場合、SSR ルートへのリクエストが誤って 404 を返していた問題を修正しました(#16878)。
プリレンダリングと SSR の動的ルートを混在させているプロジェクトで予期しない 404 が発生していた場合、このパッチで解消されます。
EOL / サポート状況
Astro の endoflife.date データは現時点では提供されていません。npm の latest タグは 6.4.2 です。
| タグ | バージョン |
|---|---|
| latest | 6.4.2 |
| alpha | 7.0.0-alpha.1 |
| legacy | 4.16.19 |
Astro 7 の alpha が公開されており、次世代の変更点を先行確認できます。
開発者への影響
- Starlight 利用者:
@astrojs/mdxバージョンによってはクラッシュが発生していた可能性があります。v6.4.2 への更新で解消されます - pre-6.0
@astrojs/mdx利用者: Astro 6.x に移行後もインテグレーション由来のクラッシュが解消されます @astrojs/nodeアダプター + 動的ルート混在利用者: プリレンダリング/SSR の動的ルートを混在させている本番環境で 404 が発生していた場合、このパッチで修正されます- その他の利用者: 直接の影響はありませんが、定期メンテナンスの一環として更新を推奨します
アップデート方法
# npm
npm update astro
# yarn
yarn upgrade astro
# pnpm
pnpm update astro
# bun
bun update astro
@astrojs/mdx を使用している場合は、合わせて最新バージョンへの更新も検討してください。
データソース: GitHub Releases API, npm Registry AI解説は Claude API により自動生成されています。正確性については原文をご確認ください。
