カテゴリ: Spring 更新日: 2026/03/04

Spring Bootのサーバー設定を完全解説!初心者でもわかるポート・コンテキストパス・圧縮・Tomcat調整

サーバー設定:ポート/コンテキストパス/圧縮/Tomcat調整
サーバー設定:ポート/コンテキストパス/圧縮/Tomcat調整

先生と生徒の会話形式で理解しよう

生徒

「Spring Bootでサーバーのポート番号を変えたり、アプリのURLの先頭を変えたりするにはどうすればいいんですか?」

先生

「それはapplication.propertiesapplication.ymlを使って設定できますよ。ポート番号の変更や、コンテキストパスの指定、さらにはレスポンスの圧縮やTomcatの調整も可能です。」

生徒

「そうなんですね!設定ファイルってたくさんあるイメージですが、基本的なものを知りたいです!」

先生

「それでは、Spring Bootでよく使われるサーバー設定について、初心者向けにひとつひとつ丁寧に解説していきましょう。」

1. ポート番号を変更する

「1. ポート番号を変更する」の重要ポイントを、初心者の方にも分かりやすく簡潔に解説します。

1. ポート番号を変更する
1. ポート番号を変更する

Spring Bootでは、デフォルトで8080ポートが使用されますが、application.propertiesapplication.ymlで簡単に変更できます。

たとえば、以下のように設定すると、サーバーは8081ポートで起動します。


server.port=8081

application.ymlを使う場合は、次のように書きます。


server:
  port: 8081

ポート番号を変えることで、他のアプリケーションと競合を避けたり、環境に応じて設定を分けることができます。

2. コンテキストパスを設定する

2. コンテキストパスを設定する
2. コンテキストパスを設定する

コンテキストパスとは、URLのルート部分に付け加えるパスのことです。例えば、http://localhost:8080/app/app部分です。

これも設定ファイルで簡単に変更できます。


server.servlet.context-path=/app

server:
  servlet:
    context-path: /app

こうすることで、すべてのエンドポイントが/appの下に配置されます。URL構成を整理したい場合に便利です。

3. レスポンスの圧縮を有効にする

3. レスポンスの圧縮を有効にする
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のスレッド数などを調整する」の重要ポイントを、初心者の方にも分かりやすく簡潔に解説します。

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. プロファイルごとに設定を分ける

5. プロファイルごとに設定を分ける
5. プロファイルごとに設定を分ける

Spring Bootでは、@Profileアノテーションや、プロパティファイルを環境別に分けることで、開発・テスト・本番で設定を切り替えることができます。

たとえば、以下のように設定ファイルを分けて用意します。

  • application-dev.properties
  • application-prod.properties

そして起動時にプロファイルを指定します。


--spring.profiles.active=dev

これにより、環境に応じたサーバー設定やデータベース設定を柔軟に切り替えることができます。

6. アプリケーションの起動バナーを非表示にする

6. アプリケーションの起動バナーを非表示にする
6. アプリケーションの起動バナーを非表示にする

ちょっとした設定ですが、Spring Boot起動時のロゴ(バナー)を非表示にする方法もあります。


spring.main.banner-mode=off

見た目をシンプルにしたいときなどに使えます。

7. よくあるエラーと対処法

「7. よくあるエラーと対処法」の重要ポイントを、初心者の方にも分かりやすく簡潔に解説します。

7. よくあるエラーと対処法
7. よくあるエラーと対処法

設定ミスによって起動時にエラーが発生することがあります。たとえば、ポートがすでに使用中の場合は以下のようなエラーが出ます。


Web server failed to start. Port 8080 was already in use.

この場合はポート番号を変更するか、対象ポートを使っているプロセスを停止する必要があります。

8. 設定の確認方法とプロパティの優先順位

8. 設定の確認方法とプロパティの優先順位
8. 設定の確認方法とプロパティの優先順位

Spring Bootでは、複数の設定場所(コマンドライン引数、環境変数、application.propertiesなど)があるため、どの値が最終的に適用されるかは「優先順位」によって決まります。

以下の順に優先されます:

  1. コマンドライン引数
  2. OSの環境変数
  3. application.propertiesapplication.yml
  4. デフォルト値

設定値が思ったとおりに反映されないときは、優先順位を確認しましょう。

カテゴリの一覧へ
新着記事
New1
Java
JavaのStreamのreduceを完全解説!初心者でもわかる集約処理の基本
新規投稿
New2
Spring
Javaの@withinアノテーションを初心者向けに解説!Spring AOPでの使い方を完全ガイド
更新記事
New3
Spring
Springの@AfterThrowingアノテーションの使い方を完全ガイド!初心者でもわかる例外処理
更新記事
New4
Spring
Javaの@AfterReturningアノテーションの使い方を完全ガイド!初心者でもわかるAOP入門
更新記事
人気記事
No.1
Java&Spring記事人気No1
Spring
Spring BootとJavaの互換性一覧!3.5/3.4/3.3はJava 21・17に対応してる?
No.2
Java&Spring記事人気No2
Thymeleaf
Thymeleafのth:checkedの使い方!チェックボックスON/OFFを動的に制御する方法
No.3
Java&Spring記事人気No3
Thymeleaf
Thymeleaf(タイムリーフ)の使い方入門!初心者でもわかるth:textの基礎
No.4
Java&Spring記事人気No4
Java
Javaの抽象クラス(abstract)を完全ガイド!継承と設計のルールを学ぶ
No.5
Java&Spring記事人気No5
Spring
Spring BootのMultipartFile入門:ファイルアップロード・ダウンロードの実装方法と制限設定
No.6
Java&Spring記事人気No6
Spring
Thymeleaf(タイムリーフ)入門!初心者でもわかるSpring Bootとテンプレートエンジンの使い方
No.7
Java&Spring記事人気No7
Spring
SpringのBindingResultを完全ガイド!初心者でもわかる入力チェックとエラー処理
No.8
Java&Spring記事人気No8
Thymeleaf
Thymeleafのth:blockの使い方を完全ガイド!初心者でもわかるテンプレートブロック管理