Spring Bootのポート番号とコンテキストパスの変更方法！起動トラブルを防ぐ基本設定ガイド

1. Spring Bootのデフォルトポートとコンテキストパス

1. Spring Bootのデフォルトポートとコンテキストパス

Spring Bootでは、特別な設定を行わない場合、Webサーバーは自動的にポート番号8080で起動し、コンテキストパスは/（ルート）として扱われます。これは「最初からすぐに動かせる」ことを重視したSpring Bootの特徴でもあり、初心者でも迷わずWebアプリを起動できるようになっています。

そのため、ブラウザからは次のようなURLでアプリケーションにアクセスできます。

http://localhost:8080/

ここでのlocalhostは「自分のパソコン自身」を意味し、8080はSpring Bootが待ち受けている通信番号（ポート番号）です。まだWebの仕組みに慣れていない場合は、「住所の番号」のようなものだと考えると分かりやすいでしょう。

ただし、この8080番ポートは開発中によく使われるため、すでに他のSpring Bootアプリや別のWebサーバーが使用していることもあります。その場合、アプリ起動時にエラーが発生し、サーバーが立ち上がりません。これがいわゆるポート競合エラーです。

まずは「デフォルトでは8080番とルートパスが使われている」という点をしっかり押さえておくと、後の設定変更やトラブル対応が理解しやすくなります。

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

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

ポート番号を変えたいときは、Spring Bootの設定ファイルであるapplication.ymlに書くだけでOKです。アプリを起動したまま画面をいじるのではなく、「起動時の設定」を変えるイメージなので、初心者の方でも手順が分かりやすい方法です。

たとえば、デフォルトの8080が他のアプリと重なって起動できない場合は、次のようにポート番号を8081へ変更します。

server:
  port: 8081

設定を書いたら、Spring Bootアプリを再起動してください。再起動後は、アクセス先のURLが次のように変わります。

http://localhost:8081/

ここで大事なのは、ブラウザで開くURLのポート番号も同じように変えることです。よくあるつまずきとして「設定は変えたのに、いつも通り8080で開いてしまい、つながらない」というケースがあります。

また、ポート番号は基本的に1024以上の未使用番号を選ぶのが安全です。開発用なら8081や8082など、近い番号にしておくと覚えやすく、複数のSpring Bootアプリを同時に動かすときにも管理が楽になります。

3. application.propertiesでポートを指定する場合

3. application.propertiesでポートを指定する場合

application.ymlではなく、application.propertiesを使っているプロジェクトでも、ポート番号の変更はとても簡単です。書き方が「キー＝値」の形なので、設定ファイルに慣れていない初心者の方でも読みやすいのが特徴です。

たとえば、ポート番号を8082に変更したい場合は、次の1行を追加（または書き換え）します。

server.port=8082

保存したら、Spring Bootアプリを再起動してください。再起動後は、アクセスするURLも次のように変わります。

http://localhost:8082/

ここでのポイントは「設定を変えたら、ブラウザで開くURLのポート番号も合わせて変える」ことです。設定だけ変えてURLを変え忘れると、画面が開かずに焦りやすいので注意しましょう。

また、複数のSpring Bootアプリを同時に起動する場合は、8081、8082、8083のように番号を分けておくと管理がしやすく、ポート競合による起動エラーも避けやすくなります。

4. コンテキストパスの変更方法

4. コンテキストパスの変更方法

コンテキストパスとは、WebアプリのURLに付く「アプリ名のような道しるべ」です。デフォルトでは/（ルート）なので、http://localhost:8080/のようにシンプルなURLでアクセスできますが、アプリを分けて管理したいときや、URLを分かりやすくしたいときはコンテキストパスを変更すると便利です。

たとえば、アプリの入口を/myappにしたい場合は、application.ymlに次のように書きます。

server:
  servlet:
    context-path: /myapp

設定を書いたら、Spring Bootアプリを再起動してください。再起動後は、アクセスするURLが次のように変わります。

http://localhost:8080/myapp/

ここでつまずきやすいのが、「以前のURL（http://localhost:8080/）にアクセスしてしまい、404になる」ケースです。コンテキストパスを変えたら、ブラウザのURLも必ず変更後のパスに合わせましょう。

また、コンテキストパスは先頭に/を付けるのが基本です。短くても意味が伝わる名前にしておくと、複数のSpring Bootアプリを動かすときも整理しやすくなります。

5. ポートやパスの指定ミスによる起動エラー

5. ポートやパスの指定ミスによる起動エラー

Spring Bootでよくある起動トラブルの代表が、「アプリは起動しようとしているのに、途中で止まってしまう」ケースです。原因として多いのが、ポート番号の競合や、コンテキストパスの勘違いです。どちらも設定を少し見直すだけで直せることが多いので、落ち着いて確認していきましょう。

まず、次のようなエラーが出た場合は、Spring Bootが使おうとしているポート（例：8080）が、すでに他のアプリで使われています。

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

この場合は、application.ymlまたはapplication.propertiesで別のポート番号に変更してから再起動します。たとえば8081や8082など、近い番号にずらすだけでも解決しやすいです。

もう一つの落とし穴が、コンテキストパスを変更したのに、以前のURLのままアクセスしてしまうことです。たとえば/myappに変更しているのに、http://localhost:8080/のまま開くと、画面が見つからず404になることがあります。正しいURL（例：http://localhost:8080/myapp/）になっているかを確認しましょう。

初心者向けに、つまずいたときの確認ポイントをまとめると次の通りです。

• エラーに「Port 8080 was already in use」と出たら、ポート番号を変更して再起動する
• コンテキストパスを変えたら、ブラウザで開くURLもそのパスに合わせる
• 設定を変えたら、基本は「保存 → 再起動 → URL確認」の順で見直す

たとえばポートを変更した直後にアクセスするURLは、次のように「変更後の番号」に合わせます。

http://localhost:8081/

こうした起動エラーは、慣れてくると「どこを見ればいいか」が分かってきます。まずはポート番号とアクセスURL、そしてコンテキストパスの3点セットを確認する習慣を付けておくと安心です。

6. コマンドライン引数でポートを指定する方法

6. コマンドライン引数でポートを指定する方法

設定ファイルを書き換えずに、一時的にポート番号を変更したい場合は、コマンドライン引数を使う方法が便利です。これは「今回の起動だけポートを変えたい」といった場面でよく使われます。

たとえば、Spring BootのJARファイルを実行するときに、次のように--server.portを指定します。

java -jar myapp.jar --server.port=9090

このコマンドを実行すると、設定ファイルの内容に関係なく、この起動時だけポート番号が9090になります。アプリを終了して、何も指定せずに再起動すれば、元のポート番号に戻る点も覚えておきましょう。

初心者の方がよく使うシーンとしては、「他のSpring Bootアプリを止めずに確認したい」「一度だけ別ポートで動作チェックしたい」といったケースです。設定ファイルを編集しないため、元に戻し忘れる心配が少ないのもメリットです。

なお、この方法でもアクセスするURLはポート番号に合わせて変更する必要があります。上記の例では、ブラウザから次のURLでアクセスします。

http://localhost:9090/

コマンドライン引数は「一時的な切り替え」、設定ファイルは「常に使う設定」と覚えておくと、使い分けがしやすくなります。

7. プロファイルごとにポートやパスを切り替える

7. プロファイルごとにポートやパスを切り替える

application.ymlではプロファイルごとに設定を切り替えることもできます。

spring:
  profiles: dev
server:
  port: 8085
  servlet:
    context-path: /devapp
---
spring:
  profiles: prod
server:
  port: 80
  servlet:
    context-path: /

プロファイルの切り替えはspring.profiles.activeで指定できます。

spring:
  profiles:
    active: dev

8. Tomcat以外のサーバーでも同様の設定が可能

8. Tomcat以外のサーバーでも同様の設定が可能

Spring BootはデフォルトでTomcatを使っていますが、JettyやUndertowに変更した場合でもserver.portやserver.servlet.context-pathの設定は同様に機能します。設定の記述は共通なので、サーバー種別によらず覚えておくと便利です。

9. ポート番号を環境変数で切り替えるテクニック

9. ポート番号を環境変数で切り替えるテクニック

クラウド環境やCI/CDでは、環境変数からポート番号を指定することが一般的です。

たとえば、環境変数SERVER_PORTを使ってSpring Bootが起動時にポートを取得するように設定しておくと、環境に応じた柔軟な起動が可能になります。

export SERVER_PORT=8888
java -jar myapp.jar

まとめ

まとめ

Spring Bootにおけるポート番号とコンテキストパスの重要性

Spring BootでWebアプリケーションを開発するうえで、ポート番号とコンテキストパスの設定は非常に基本でありながら、実務や学習の初期段階でつまずきやすいポイントでもあります。デフォルトではポート番号は8080、コンテキストパスはルートであるスラッシュが設定されており、特別な設定をしなくてもすぐにアプリを起動できるのがSpring Bootの大きな特徴です。 しかし、複数のSpring Bootアプリを同時に起動したり、すでに別のWebサーバーや開発ツールが同じポート番号を使用していた場合、起動時にエラーが発生することがあります。このような状況を避けるためにも、ポート番号の変更方法や設定ファイルの書き方を理解しておくことが重要です。

設定ファイルによる柔軟なカスタマイズ

application.ymlやapplication.propertiesを使えば、ポート番号やコンテキストパスを簡単に変更できます。これらの設定はアプリケーション起動時に読み込まれるため、設定変更後は必ず再起動が必要になります。URLのポート番号やパスを変更した場合、ブラウザからアクセスする際のURLも同じように変更しなければならない点は、初心者が特に注意したいポイントです。 また、プロファイル機能を使えば、開発環境や本番環境ごとに異なるポート番号やパスを設定できます。これにより、ローカル開発では8080番台、本番環境では80番や443番を使うといった運用もスムーズに行えます。

起動トラブルを防ぐための実践的な考え方

ポート競合による起動エラーは、Spring Bootを学び始めた多くの人が一度は経験するトラブルです。エラーメッセージを正しく読み取り、「どのポートが使われているのか」「設定ファイルで変更できるのか」を落ち着いて確認することで、問題は意外と簡単に解決できます。 一時的な検証や動作確認では、コマンドライン引数でポート番号を指定する方法も便利です。設定ファイルを変更せずに起動時だけポートを変えられるため、テスト用途や複数人での開発でも役立ちます。

サンプル設定の振り返り

server:
  port: 8081
  servlet:
    context-path: /sample

このような設定を行うことで、Spring Bootアプリは指定したポート番号とコンテキストパスで起動します。URL構造を意識して設定できるようになると、Webアプリ全体の構成が理解しやすくなり、コントローラーや画面遷移の設計にも良い影響を与えます。