brand logo

ドキュメント

サーバーエンジン

Nuxtは新しいサーバーエンジン:Nitroによって動作します。

Nuxtを構築する際に、新しいサーバーエンジンを作成しました:Nitro

これは多くの機能を備えています:

  • Node.js、ブラウザ、サービスワーカーなどのクロスプラットフォームサポート。
  • サーバーレスサポートを標準装備。
  • APIルートのサポート。
  • 自動コード分割と非同期ロードチャンク。
  • 静的+サーバーレスサイトのハイブリッドモード。
  • ホットモジュールリロードを備えた開発サーバー。

APIレイヤー

サーバーのAPIエンドポイントミドルウェアは、内部でh3を使用するNitroによって追加されます。

主な機能には以下が含まれます:

  • ハンドラーは自動的に処理されるJSONレスポンスのためにオブジェクト/配列を直接返すことができます
  • ハンドラーはプロミスを返すことができ、これが待機されます(res.end()next()もサポートされています)
  • ボディ解析、クッキー処理、リダイレクト、ヘッダーなどのためのヘルパー関数

詳細については、h3のドキュメントを参照してください。

こちらも参照 guide > directory-structure > server#server-routes

直接APIコール

Nitroは、グローバルに利用可能な$fetchヘルパーを介してルートの「直接」呼び出しを可能にします。これはブラウザで実行される場合はサーバーへのAPIコールを行いますが、サーバーで実行される場合は関連する関数を直接呼び出し、追加のAPIコールを節約します。

$fetch APIはofetchを使用しており、主な機能には以下が含まれます:

  • JSONレスポンスの自動解析(必要に応じて生のレスポンスへのアクセスも可能)
  • リクエストボディとパラメータは自動的に処理され、正しいContent-Typeヘッダーが設定されます

$fetchの機能についての詳細は、ofetchを参照してください。

型付きAPIルート

APIルート(またはミドルウェア)を使用する際、Nitroはこれらのルートの型を生成します。ただし、res.end()を使用してレスポンスを送信するのではなく、値を返す必要があります。

これらの型は、$fetch()またはuseFetch()を使用する際にアクセスできます。

スタンドアロンサーバー

Nitroは、node_modulesに依存しないスタンドアロンのサーバーdistを生成します。

Nuxt 2のサーバーはスタンドアロンではなく、nuxt startnuxt-startまたはnuxtディストリビューションを使用)を実行することでNuxtコアの一部を関与させる必要があり、これは脆弱で壊れやすく、サーバーレスやサービスワーカー環境には適していません。

Nuxtは、nuxt buildを実行する際に、このdistを.outputディレクトリに生成します。

この出力には、あらゆる環境(実験的なブラウザサービスワーカーを含む)でNuxtサーバーを実行し、静的ファイルを提供するためのランタイムコードが含まれており、JAMstackのための真のハイブリッドフレームワークとなっています。さらに、Nuxtはネイティブストレージレイヤーを実装しており、マルチソースドライバーとローカルアセットをサポートしています。

こちらも参照 github.com > nitrojs > nitro

tips

このセクションは公式ドキュメントの翻訳ではなく、本サイト独自の補足記事です。

NuxtのサーバーエンジンNitroとは?〜何が嬉しいのか〜

Nuxtは従来のサーバー構成から一歩進み、Nitroという新しいサーバーエンジンを採用しています。Nitroは単なるサーバーランタイムではなく、Node.jsだけでなくブラウザやサービスワーカーなど多様な環境で動作可能なクロスプラットフォーム対応のエンジンです。

これにより、サーバーレス環境や静的サイト生成(SSG)との親和性が高まり、APIルートの実装やホットリロードなど開発体験も大幅に向上しました。さらに、NitroはAPIコールの最適化や自動コード分割などの機能を備え、パフォーマンス面でも優れています。

つまり、Nitroを使うことで、Nuxtアプリケーションのサーバーサイド処理をより柔軟かつ効率的に実装できるようになり、モダンなWeb開発の課題を解決できるのです。

まず結論:Nitroのポイントまとめ

  • クロスプラットフォーム対応:Node.jsだけでなくブラウザやサービスワーカーでも動作可能
  • サーバーレス対応が標準装備:AWS LambdaやVercelなどの環境に最適化
  • APIルートの簡単実装server/ディレクトリにAPIエンドポイントを置くだけでOK
  • 直接APIコールの最適化:サーバー内では関数呼び出しに置き換わり余計な通信を削減
  • スタンドアロンのサーバー出力nuxt buildで依存なしの実行可能なサーバーを生成
  • 開発体験の向上:ホットモジュールリロード対応で高速なフィードバックループ

いつ使うべきか?使わない方がよいケースは?

Nitroは基本的にNuxt 3の標準サーバーエンジンとして設計されているため、Nuxt 3を使うならほぼ必須です。特に以下のようなケースで効果を発揮します。

  • サーバーレス環境でのデプロイを検討している場合
  • APIルートをNuxt内で管理したい場合(外部APIサーバーを別途用意しなくてよい)
  • 静的サイト生成とサーバーサイド処理を組み合わせたい場合
  • 開発時のホットリロードを活用したい場合

一方で、以下のようなケースではNitroの恩恵が薄いか、使いづらいこともあります。

  • 既存の大規模なNode.jsサーバーやExpress/Koaなどのフレームワークを使い続けたい場合
  • NitroのAPIルートの仕組みが合わず、複雑なミドルウェアやカスタムサーバー処理が必要な場合
  • Nuxt 2など旧バージョンを使っている場合(NitroはNuxt 3向け)

実務でよくあるユースケースとサンプルコード

1. APIルートの簡単実装

server/api/hello.get.ts のようにファイルを作るだけでAPIエンドポイントが作成できます。

export default defineEventHandler(() => {
  return { message: 'Hello from Nitro API!' }
})

このAPIはブラウザから/api/helloで呼び出せ、サーバー側では直接関数として呼び出せるため高速です。

2. $fetchを使った直接APIコールの最適化

サーバーサイドでAPIを呼ぶ際、通常のHTTPリクエストではなく関数呼び出しに置き換わるため、余計な通信コストがかかりません。

const data = await $fetch('/api/hello')
console.log(data.message) // "Hello from Nitro API!"

3. スタンドアロンサーバーの生成とデプロイ

nuxt build後、.outputディレクトリに依存なしのサーバーが生成されます。これをそのままサーバーレス環境やDockerコンテナにデプロイ可能です。

nuxt build
node .output/server/index.mjs

よくある落とし穴・注意点

SSRとHydrationのズレに注意

APIルートで返すデータがSSR時とクライアント側で異なると、Hydrationエラーが発生することがあります。APIレスポンスはできるだけ一貫性を保ちましょう。

パフォーマンス面の注意

  • $fetchの直接呼び出しは便利ですが、サーバー内で重い処理を連続して呼ぶとブロッキングになる可能性があります。適切に非同期処理やキャッシュを活用してください。
  • APIルートの数が増えすぎるとビルド時間が長くなることがあります。必要なAPIだけを整理しましょう。

ミドルウェアの使い方

Nitroはh3ベースのミドルウェアをサポートしますが、Expressのような複雑なミドルウェアチェーンは使えません。必要に応じてh3のドキュメントを参照し、シンプルな設計を心がけてください。

まとめ

NitroはNuxt 3のサーバーエンジンとして、クロスプラットフォーム対応やサーバーレス対応、APIルートの簡単実装など多くのメリットをもたらします。実務ではAPIの直接呼び出しやスタンドアロンサーバーの活用が特に便利です。

ただし、SSRの一貫性やパフォーマンス面の注意も必要なので、設計段階で適切に理解し活用することが重要です。Nuxtのモダンな開発体験を最大限に引き出すために、Nitroの特徴をしっかり押さえておきましょう。