Spring Bootのサーバー設定を完全解説!初心者でもわかるポート・コンテキストパス・圧縮・Tomcat調整
生徒
「Spring Bootでサーバーのポート番号を変えたり、アプリのURLの先頭を変えたりするにはどうすればいいんですか?」
先生
「それはapplication.propertiesやapplication.ymlを使って設定できますよ。ポート番号の変更や、コンテキストパスの指定、さらにはレスポンスの圧縮やTomcatの調整も可能です。」
生徒
「そうなんですね!設定ファイルってたくさんあるイメージですが、基本的なものを知りたいです!」
先生
「それでは、Spring Bootでよく使われるサーバー設定について、初心者向けにひとつひとつ丁寧に解説していきましょう。」
1. ポート番号を変更する
「1. ポート番号を変更する」の重要ポイントを、初心者の方にも分かりやすく簡潔に解説します。
Spring Bootでは、デフォルトで8080ポートが使用されますが、application.propertiesやapplication.ymlで簡単に変更できます。
たとえば、以下のように設定すると、サーバーは8081ポートで起動します。
server.port=8081
application.ymlを使う場合は、次のように書きます。
server:
port: 8081
ポート番号を変えることで、他のアプリケーションと競合を避けたり、環境に応じて設定を分けることができます。
2. コンテキストパスを設定する
コンテキストパスとは、URLのルート部分に付け加えるパスのことです。例えば、http://localhost:8080/appの/app部分です。
これも設定ファイルで簡単に変更できます。
server.servlet.context-path=/app
server:
servlet:
context-path: /app
こうすることで、すべてのエンドポイントが/appの下に配置されます。URL構成を整理したい場合に便利です。
3. レスポンスの圧縮を有効にする
Webアプリケーションでは、通信の効率を上げるためにレスポンスを圧縮することが重要です。Spring BootではGZIP圧縮を簡単に有効にできます。
server.compression.enabled=true
server.compression.mime-types=application/json,application/xml,text/html,text/xml,text/plain
server.compression.min-response-size=1024
上記の設定では、レスポンスサイズが1024バイト以上の場合に、指定されたMIMEタイプのレスポンスが圧縮されます。
YAML形式では以下のようになります。
server:
compression:
enabled: true
mime-types: application/json,application/xml,text/html,text/xml,text/plain
min-response-size: 1024
これにより、クライアントへのデータ転送が軽くなり、表示速度の向上につながります。
4. Tomcatのスレッド数などを調整する
「4. Tomcatのスレッド数などを調整する」の重要ポイントを、初心者の方にも分かりやすく簡潔に解説します。
Spring Bootの組み込みサーバーであるApache Tomcatは、リクエスト処理の性能を設定でカスタマイズできます。
server.tomcat.max-threads=200
server.tomcat.min-spare-threads=10
server.tomcat.accept-count=100
各項目の意味は次のとおりです:
- max-threads:処理スレッドの最大数(デフォルトは200)
- min-spare-threads:アイドル状態で待機するスレッドの最小数
- accept-count:同時接続リクエストの待機キューの最大数
これらの調整により、高負荷時のレスポンス性能を安定させることが可能です。
5. プロファイルごとに設定を分ける
Spring Bootでは、@Profileアノテーションや、プロパティファイルを環境別に分けることで、開発・テスト・本番で設定を切り替えることができます。
たとえば、以下のように設定ファイルを分けて用意します。
application-dev.propertiesapplication-prod.properties
そして起動時にプロファイルを指定します。
--spring.profiles.active=dev
これにより、環境に応じたサーバー設定やデータベース設定を柔軟に切り替えることができます。
6. アプリケーションの起動バナーを非表示にする
ちょっとした設定ですが、Spring Boot起動時のロゴ(バナー)を非表示にする方法もあります。
spring.main.banner-mode=off
見た目をシンプルにしたいときなどに使えます。
7. よくあるエラーと対処法
「7. よくあるエラーと対処法」の重要ポイントを、初心者の方にも分かりやすく簡潔に解説します。
設定ミスによって起動時にエラーが発生することがあります。たとえば、ポートがすでに使用中の場合は以下のようなエラーが出ます。
Web server failed to start. Port 8080 was already in use.
この場合はポート番号を変更するか、対象ポートを使っているプロセスを停止する必要があります。
8. 設定の確認方法とプロパティの優先順位
Spring Bootでは、複数の設定場所(コマンドライン引数、環境変数、application.propertiesなど)があるため、どの値が最終的に適用されるかは「優先順位」によって決まります。
以下の順に優先されます:
- コマンドライン引数
- OSの環境変数
application.propertiesやapplication.yml- デフォルト値
設定値が思ったとおりに反映されないときは、優先順位を確認しましょう。