MicronautのHTTPサーバー設定を理解！ポート変更・スレッド数などの調整方法

1. HTTPサーバーの基本設定とポート番号の変更

1. HTTPサーバーの基本設定とポート番号の変更

Micronautで作成したアプリケーションは、標準（デフォルト）では「8080」というポート番号を使って通信を待ち受けます。しかし、他のソフトがすでに8080を使っていたり、本番環境の指定があったりする場合は、設定ファイル（application.yml）を書き換えるだけで簡単に変更可能です。

プログラミングに慣れていない方でも安心してください。設定は「どの住所（ホスト）の、どのドア（ポート）を開けるか」を記述するだけです。例えば、ポート番号を「9090」に変更し、どこからでも接続できるようにするには、以下のように記述します。

micronaut:
  server:
    # サーバーが待ち受けるポート番号を指定します
    port: 9090
    # 0.0.0.0を指定すると、外部からのアクセスをすべて許可します
    host: 0.0.0.0

この設定を反映させてアプリを起動すると、ブラウザなどで http://localhost:9090 と入力するだけでアクセスできるようになります。もしポート番号を「-1」に設定した場合は、空いているポートがランダムで割り当てられるため、テスト実行時などに非常に便利です。

初心者向け：Javaコードで設定値を読み込む例

設定したポート番号をプログラムの中で使いたい場合、Micronautでは「@Value」という注釈（アノテーション）を使うだけで、自動的に設定値を読み込むことができます。まずは難しく考えず、以下のサンプルを見てみましょう。

import io.micronaut.context.annotation.Value;
import jakarta.inject.Singleton;

@Singleton
public class WelcomeMessage {
    // application.ymlの port の値を読み込みます
    @Value("${micronaut.server.port}")
    protected int serverPort;

    public String getGreeting() {
        return "サーバーはポート " + serverPort + " で元気に動いています！";
    }
}

このように、設定ファイル（YAML）とJavaプログラムを連携させることで、プログラムを書き換えずに動作環境（開発用、本番用など）に合わせて柔軟にサーバーの挙動をコントロールできるのがMicronautの大きな強みです。

2. スレッド数やパフォーマンス調整：Nettyを最適化する

2. スレッド数やパフォーマンス調整：Nettyを最適化する

Micronautは、非常に高速な通信エンジンであるNetty（ネッティ）を基盤として動作しています。Nettyは「イベントループ」という仕組みで大量のリクエストを効率よく処理しますが、デフォルト設定のままではマシンの性能をフルに引き出せないことがあります。

特に、大量のアクセスが予想されるアプリケーションでは、以下の設定を application.yml に追加して、サーバーの「筋肉量（スレッド数）」を調整しましょう。プログラミングに慣れていない方でも、まずは「どれだけ同時に動くか」を決める設定だと考えれば大丈夫です。

micronaut:
  server:
    netty:
      # 同時に処理を行うスレッドの数（CPUの核心数に合わせて調整）
      eventLoopThreads: 16
      # I/O処理（通信）とその他の処理の優先度比率
      ioRatio: 70
      # 1つのスレッドが一度に処理するタスクの最大数
      maxRequestsPerRound: 256

eventLoopThreads は、いわば「窓口の担当者数」です。これを増やすことで、同時に受け付けられる仕事の量が増えます。また、ioRatio は「通信作業」と「計算作業」のバランスを調整する数値です。数値を大きくすると通信の応答性が高まり、高負荷な環境でもサクサク動くようになります。

このように、Micronautではコードを一行も書き換えることなく、設定ファイルを数行いじるだけで、Javaアプリケーションの実行速度を劇的に向上させることが可能です。サーバーのスペックに合わせて、最適な数値を見つけてみてください。

3. HTTPSやポート範囲の設定

3. HTTPSやポート範囲の設定

MicronautではHTTPSを有効化する場合もapplication.ymlで簡単に設定可能です。SSL証明書やキーストアの指定もここで行います。

micronaut:
  server:
    ssl:
      enabled: true
      key-store:
        path: classpath:keystore.jks
        password: secret
      port: 8443

この設定でHTTPSはポート8443で起動し、安全な通信が可能になります。SEOキーワード：Micronaut HTTPS設定、SSL Micronaut、ポート8443、Java Micronaut セキュアサーバー

4. Javaコードからのサーバー設定確認

4. Javaコードからのサーバー設定確認

MicronautではJavaコードからサーバー設定を取得してログ出力することも可能です。

import io.micronaut.context.annotation.Value;
import jakarta.inject.Singleton;

@Singleton
public class ServerInfo {
    @Value("${micronaut.server.port}")
    private int port;

    public void printServerPort() {
        System.out.println("HTTPサーバーはポート " + port + " で起動しています");
    }
}

このようにして、起動中のサーバーポートをコード上で取得でき、デバッグや環境別設定確認に便利です。SEOキーワード：Micronaut Java サーバー設定、ポート確認、Micronaut 開発者向けガイド、サーバー情報取得

5. 実務での活用ポイント

5. 実務での活用ポイント

• 開発環境・本番環境でポート番号を変えて複数アプリを同時起動
• Nettyのスレッド数を調整して負荷に応じた最適化
• HTTPSやSSL設定で安全な通信を確保
• Javaコードから設定値を参照してログ出力や条件分岐に利用
• Micronautの外部設定機能を活用して、環境ごとに柔軟なサーバー設定を管理

SEOキーワード：Micronaut HTTPサーバー、ポート設定、スレッド調整、Netty設定、Java Micronaut 開発、環境別設定、HTTPS対応