MicronautのHTTPサーバー設定ガイド！ポート番号変更やスレッド数調整を完全解説

1. Micronautの設定ファイルの基本

1. Micronautの設定ファイルの基本

Micronaut（マイクロノート）のHTTPサーバー設定を行う際、最も頻繁に利用するのが「application.yml（アプリケーション・ワイエムエル）」というファイルです。このファイルは、Javaのプログラムコードとは別に、サーバーの動作ルールを記述するための専用のメモ帳のようなものです。プログラミング未経験の方でも、家電の設定メニューを操作する感覚で理解できます。

このファイルは通常、プロジェクト内のリソースフォルダに置かれており、階層構造を使って設定を記述します。例えば「サーバーの、ポートを、これにする」という風に、段階を追って指示を出します。Micronautは起動時にこのファイルを読み込み、そこに書かれた内容に従ってWebサーバーを準備します。書き間違いがあるとエラーになりますが、基本の型が決まっているので一度覚えれば非常に簡単です。

2. ポート番号を変更する方法

2. ポート番号を変更する方法

デフォルトの状態では、Micronautのサーバーは「8080番」というポート番号で待ち受けを行います。しかし、他のソフトが既にその番号を使っていたり、本番環境のルールで変更が必要だったりすることがあります。ポート番号の変更は、設定ファイルの最も基本的な操作の一つです。

設定ファイルに「micronaut.server.port」という項目を追加し、好きな数字を指定するだけです。例えば「9000番」に変更したい場合は、以下のように記述します。これにより、次回起動時から新しい番号でアクセスできるようになります。パソコン上の住所の「部屋番号」を書き換えるようなイメージです。

micronaut:
  server:
    port: 9000

3. 最大スレッド数と並列処理の仕組み

3. 最大スレッド数と並列処理の仕組み

Webサーバーには、一度にどれくらいの人数のお願い（リクエスト）を同時に聞けるか、という「並列処理」の限界があります。これを支えているのが「スレッド」と呼ばれるものです。スレッドは、サーバーの中で働く「作業員」だと考えてください。作業員が多ければ一度にたくさんの処理ができますが、多すぎるとパソコンのメモリを使い果たしてしまいます。

Micronautはデフォルトで、お使いのパソコンの性能に合わせて自動的にスレッド数を調整してくれます。しかし、アクセスが非常に多いアプリを作る場合は、この作業員の数を手動で増やしてあげる必要があります。逆に、メモリが少ない環境では、あえて作業員を減らして省エネ運転をさせることもあります。このバランス調整が、安定したサーバー運営の鍵となります。

4. イベントループスレッドの調整

4. イベントループスレッドの調整

Micronautの裏側では、Netty（ネッティ）という非常に高速な仕組みが動いています。Nettyには「イベントループスレッド」という、主に通信の受付や管理を行う特殊な作業員がいます。この作業員は、リクエストを受け取って内容を整理する、いわば「受付担当」です。

通常、この数はCPUの芯（コア）の数に応じて決まりますが、これも設定で変更可能です。通信のやり取りが非常に激しいアプリでは、この受付担当を増やすことで、サーバーの反応速度を向上させることができます。プログラミングの専門用語では「ノンブロッキングI/O」を支える重要な設定項目となります。

micronaut:
  server:
    netty:
      worker:
        threads: 16

5. リクエストボディの最大サイズを変更する

5. リクエストボディの最大サイズを変更する

ユーザーがサーバーに大きな画像やファイルを送ろうとしたとき、サーバー側で「そんなに大きなデータは受け取れません！」と断ることがあります。これはサーバーをパンクさせないための防御機能ですが、写真共有アプリなどを作る場合には、この制限を緩めてあげる必要があります。

「max-request-size」という項目を設定することで、受け入れ可能なデータの大きさを調整できます。単位はバイトで指定しますが、1MBや10MBといった分かりやすい形式で書くことも可能です。初心者のうちは、あまり大きくしすぎるとサーバーが重くなる原因になるので、必要な分だけ広げるのがコツです。配送センターの「荷物の最大重量制限」を変えるようなものですね。

6. 読み取りタイムアウトの設定

6. 読み取りタイムアウトの設定

通信の状態が悪いとき、サーバーはずっと返事を待ち続けてしまうことがあります。これを防ぐのが「タイムアウト」設定です。一定時間待ってもデータが届かない場合に、通信を打ち切って次の仕事に移るための仕組みです。これは、特定の作業員が一人の客にかかりきりになって、行列ができてしまうのを防ぐために重要です。

適切な待ち時間を設定することで、サーバー全体の回転率を高めることができます。あまり短すぎると普通のユーザーも追い出してしまいますし、長すぎるとサーバーが詰まってしまいます。アプリの種類に合わせて、「ちょっと長めに待つ」「サッサと切り上げる」といった性格付けをここで行います。レストランの「予約の待ち時間」を制限するルールと同じです。

micronaut:
  server:
    read-timeout: 30s

7. CORS設定で異なるドメインからのアクセスを許可する

7. CORS設定で異なるドメインからのアクセスを許可する

最近のWeb開発では、フロントエンド（画面側）とバックエンド（サーバー側）を分けて作ることが一般的です。その際、セキュリティ上の理由で「違う場所からのアクセス」が禁止されることがあります。これを解決するのがCORS（コルス）設定です。

Micronautでは、設定ファイルで特定のドメインからのアクセスを許可するように指定できます。これを設定しないと、開発中に「プログラムは合っているはずなのに、画面にデータが表示されない！」という壁にぶつかることがあります。安全な通信を保ちつつ、必要な扉だけを開けるための大切な設定です。マンションのオートロックに特定の訪問者を登録するようなイメージです。

micronaut:
  server:
    cors:
      enabled: true
      configurations:
        web:
          allowedOrigins:
            - "http://localhost:3000"

8. 環境変数を利用した柔軟な設定上書き

8. 環境変数を利用した柔軟な設定上書き

同じアプリでも、自分のパソコンで動かす時と、インターネット上の本番用パソコンで動かす時では、設定を変えたい場合があります。そんな時に便利なのが「環境変数」です。application.ymlに直接数字を書く代わりに、OS（WindowsやMac）側の設定を読み取らせることができます。

例えば、ポート番号を「MICRONAUT_SERVER_PORT」という名前の環境変数から読み取るようにしておけば、プログラムファイルを書き換えなくても、OSの設定を変えるだけで動作を切り替えられます。これは、同じマニュアルを使いながら、場所によって指示内容を変えるための賢いテクニックです。プロの現場では、セキュリティ向上のためにも多用されます。

9. 開発環境でのホットリロード設定

9. 開発環境でのホットリロード設定

プログラミングをしている時、一文字書き換えるたびにサーバーを再起動するのは非常に時間がもったいないです。Micronautには、変更を検知して自動で反映させる「ホットリロード」のような仕組みを助ける機能があります。これには設定だけでなく、ビルドツール（GradleやMaven）との連携も必要ですが、サーバー側の設定でも挙動を調整できます。

開発効率を最大化するために、静的なファイル（画像やHTML）の読み込みをキャッシュ（一時保存）しないように設定することもできます。こうすることで、画像を差し替えた瞬間にブラウザにも反映されるようになります。初心者のうちは、この「すぐ変わる」という快適さが学習のモチベーションにも繋がります。

10. サーバーログの設定で見えない動きを確認

10. サーバーログの設定で見えない動きを確認

設定が正しく反映されているか、サーバーの中で何が起きているかを確認するためには「ログ」が欠かせません。ログとは、サーバーの日記のようなものです。どの設定が読み込まれたか、どのリクエストでエラーが起きたかを詳しく記録してくれます。

ログの出力レベルを「DEBUG（デバッグ）」に設定すると、通常は隠されている細かい動きまで表示されるようになります。設定変更がうまくいかない時は、まずログを見て、サーバーが自分の指示をどう受け取ったかを確認しましょう。見えないプログラムの動きを文字として可視化することで、初心者のデバッグ作業は劇的に楽になります。サーバーとの対話を楽しむための、最も重要なツールと言えるでしょう。