結論
Spring Bootは、Spring Frameworkを設定済みの状態ですぐ動かせるようにする仕組みです。Webサーバーも中に入っていて、mainメソッドから起動できます。
この記事でわかること
- Spring Initializrの全7項目の意味と選び方
- REST APIの起動ログとcurlで呼んだ応答7種
- 起動エラー9種の原文・原因・直し方の表
Spring Boot のアプリは、Spring Initializr で作ったひな形に、自分のクラスを足して起動するだけで動きます。起動すると、Spring Boot が必要な部品を自動でそろえ、組み込みの Tomcat が HTTP を受け付けます。
flowchart TD
A[Spring Initializr でひな形を作る] --> B[starter を1つ選ぶ<br>Spring Web]
B --> C[自動設定<br>クラスパスを見て部品を用意]
C --> D[組み込み Tomcat が起動]
D --> E[コントローラーが JSON を返す]
やりたいことごとの入口は次のとおりです。
| やりたいこと | 使うもの・コマンド | 詳しくは |
|---|---|---|
| プロジェクトを作る | start.spring.io で Spring Web を選び Generate | Spring Initializrの使い方 |
| 起動する(Maven) | ./mvnw spring-boot:run |
最小のREST APIを作って動かす |
| 起動する(Gradle) | ./gradlew bootRun |
最小のREST APIを作って動かす |
| ポートを変える | server.port=8081 |
application.propertiesの書き方 |
| 起動しない | ログの「Description:」を読む | よく出る起動エラーと直し方 |
| jar にして動かす | ./mvnw package のあと java -jar |
実行可能jarを作る |
| 必要な Java を知る | Java 17 以上(4.1.1 は 26 まで) | 最新版と必要なJavaの版 |
確認環境:Spring Boot 4.1.1(Spring Framework 7.0.9・Apache Tomcat 11.0.24・Jackson 3.1.5・Logback 1.5.38 は Boot の依存管理の版)。これらを GitHub のタグのソースからビルドし、OpenJDK 21.0.10(Linux)でこの記事のアプリを起動して、起動ログ・curl の応答・起動エラーの原文を取りました。OpenJDK 17.0.20.1・25.0.4.1 での起動と、Java 8・11 で起動したときのエラーも確かめています。Spring Initializr の項目と既定値は start.spring.io のメタデータと、start.spring.io・initializr の GitHub のソース、版とサポート期限は spring.io と docs.spring.io で確かめました(確認日 2026年10月17日)。
本記事の内容は、ご自由にお使いください。
ご利用の際は、出典として本ページへのリンクを記載いただけますようお願いします。
(記載例)出典:株式会社RJC「Spring Bootとは|入門・Initializrの使い方とREST API作成」
Spring Bootとは
Spring Boot は、Java の Spring Framework を使ったアプリを「設定済み」の状態で始められるようにするフレームワークです。 公式ドキュメントは「単体で動く、本番品質の Spring ベースのアプリを作る手助けをする」と説明しています。読み方は「スプリング ブート」。検索では「springboot」と続けて書かれることもありますが、正式な表記は「Spring Boot」です。
Spring Boot が代わりにやってくれることは、主に次の4つです。
1自動設定(Auto-configuration)
クラスパスにあるライブラリを見て、必要な部品(Bean)を自動で用意する。Spring Web を入れれば、Web の受付役(DispatcherServlet)や JSON 変換が用意される。
2starter(スターター)
用途ごとの依存のまとめ。spring-boot-starter-webmvc を1つ書くと、Spring MVC・Tomcat・Jackson などが互いに合う版でそろう。
3組み込みサーバー
Tomcat がアプリの中に入っている。Tomcat を別に入れて WAR を置く作業が要らず、main メソッドから起動できる。
4実行可能 jar
アプリと依存ライブラリを1つの jar にまとめ、java -jar で起動できる。公式チュートリアルの例では約18MB。
ライセンスは Apache License 2.0 で、無料で使えます。ソースは GitHub の spring-projects/spring-boot で公開されています。
Spring FrameworkとSpring Bootの違い
Spring Framework は土台の部品の集まりで、Spring Boot はそれを「すぐ動く形」に組み立てる仕組みです。 Spring Boot を使うと、中では Spring Framework が動きます。どちらか一方を選ぶものではありません。
| 項目 | Spring Framework | Spring Boot |
|---|---|---|
| 役割 | DI・AOP・Web MVC などの土台 | Framework を設定済みで使う仕組み |
| 部品の用意 | Bean やサーバーの設定を自分で書く | クラスパスを見て自動で用意する |
| Web サーバー | WAR を作り、別の Tomcat に置く | 組み込み Tomcat を main から起動 |
| 依存の版 | 自分で合う版を探してそろえる | starter と依存管理で自動でそろう |
| 現在の版 | 7.0.9 | 4.1.1(Framework 7.0.9 を使う) |
DI(依存性の注入)は、部品どうしのつなぎ込みを Spring に任せる仕組みです。Spring Boot を使っても、コントローラーやサービスの書き方(@RestController・@Service・コンストラクタでの受け取り)は Spring Framework のものです。
Spring Bootの最新版と必要なJavaの版
2026年10月17日時点の最新の安定版は Spring Boot 4.1.1 です。docs.spring.io の動作環境のページでは、4.1.1 は Java 17 以上が必要で、Java 26 まで対応 としています。
| 項目 | Spring Boot 4.1.1 の要件 |
|---|---|
| Java | 17 以上(26 まで対応) |
| Spring Framework | 7.0.9 以上 |
| Maven | 3.6.3 以上 |
| Gradle | 8.14 以上の 8.x、または 9.x |
| 組み込みサーバー | Tomcat 11.0.x・Jetty 12.1.x(Servlet 6.1) |
spring.io が公開しているサポート期限(OSS サポート=無償で修正版が出る期間)は次のとおりです。
| 版 | 最初のリリース | OSS サポート終了 |
|---|---|---|
| 4.2.x | 2026年11月(予定) | 2027年12月31日 |
| 4.1.x | 2026年6月 | 2027年7月31日 |
| 4.0.x | 2025年11月 | 2026年12月31日 |
| 3.5.x | 2025年5月 | 2026年6月30日(終了) |
これから始めるなら 4.1.x が候補です。3.x から 4.x では starter の名前が変わり(例:spring-boot-starter-web → spring-boot-starter-webmvc)、JSON ライブラリが Jackson 3 になりました。以前の名前の starter も使えますが、非推奨です。
Java の版を変えて起動した結果
同じアプリ(Java 17 向けにコンパイル)を JDK を変えて起動しました。Java 17・21・25 では起動し、Java 8・11 では起動前に止まりました。
| Java の版 | 結果 | 起動にかかった時間 |
|---|---|---|
| 25.0.4.1 | 起動した | 2.095秒 |
| 21.0.10 | 起動した | 2.072秒 |
| 17.0.20.1 | 起動した | 4.103秒 |
| 11 | UnsupportedClassVersionError |
― |
| 8 | UnsupportedClassVersionError |
― |
Java 11 で起動したときの原文です。
Error: LinkageError occurred while loading main class com.example.demo.DemoApplication
java.lang.UnsupportedClassVersionError: com/example/demo/DemoApplication has been compiled by a more recent version of the Java Runtime (class file version 61.0), this version of the Java Runtime only recognizes class file versions up to 55.0
class file version の 61.0 は Java 17、55.0 は Java 11、52.0 は Java 8 を表します。このエラーが出たら、java -version で使っている Java を確かめます。
関連記事「Javaインストール(Windows)|JDK 25とJAVA_HOME設定まで」で扱っています。
Spring Initializrの使い方
Spring Initializr(スプリング イニシャライザー)は、Spring Boot プロジェクトのひな形を作る公式の Web サービスです。 https://start.spring.io を開き、項目を選んで Generate を押すと、zip ファイルがダウンロードされます。IDE によっては、新規プロジェクトの画面から同じ start.spring.io を呼び出せます。
start.spring.io を開き、Project と Language を選ぶ
迷ったら Maven と Java。学習用の記事や本は Maven の例が多めです。
Spring Boot の版を選ぶ
SNAPSHOT・M2 が付いていない版(2026年10月17日時点は 4.1.1)を選びます。
Project Metadata を入力する
Group・Artifact・Package name・Packaging・Configuration・Java を決めます(下の表)。
Add dependencies で Spring Web を追加する
REST API を作るなら Spring Web だけで始められます。
Generate で zip をダウンロードし、展開する
Explore を押すと、ダウンロード前に中身のファイルを画面で見られます。
画面の各項目の意味
start.spring.io のメタデータとソースで確かめた、2026年10月17日時点の項目・選択肢・既定値です。
| 項目 | 意味・選択肢 | 迷ったときの選び方 |
|---|---|---|
| Project | ビルドツール。Gradle - Groovy(既定)・Gradle - Kotlin・Maven | 会社や教材に合わせる。迷えば Maven |
| Language | Java(既定)・Kotlin・Groovy | Java |
| Spring Boot | 4.2.0 (SNAPSHOT)・4.2.0 (M2)・4.1.2 (SNAPSHOT)・4.1.1(既定)・4.0.9 (SNAPSHOT)・4.0.8 | 印の無い最新の 4.1.1 |
| Group | 組織を表す名前。既定 com.example |
自社ドメインの逆順(例 jp.co.example) |
| Artifact | プロジェクト名。既定 demo。jar 名やフォルダ名になる |
英小文字とハイフン |
| Package name | Java のパッケージ。既定 com.example.demo |
Group+Artifact のまま |
| Packaging | Jar(既定)・War | Jar。既存の Tomcat に置くときだけ War |
| Configuration | 設定ファイルの形式。Properties(既定)・YAML | どちらか一方にそろえる |
| Java | 27・25・21・17(既定 17) | 25 か 21(LTS=長期サポート版) |
| Dependencies | 追加する機能(starter) | REST API なら Spring Web |
SNAPSHOT は開発中の毎日のビルド、M2 はマイルストーン(試験公開版)です。学習や本番には、印の付いていない版を使います。
Dependencies でよく選ぶもの
| 表示名 | 入るもの | 使う場面 |
|---|---|---|
| Spring Web | Spring MVC+組み込み Tomcat+Jackson | REST API・Web アプリ |
| Spring Boot DevTools | 保存時の自動再起動など | 開発中の待ち時間を減らす |
| Validation | Hibernate Validator(入力チェック) | @NotBlank などで入力を検査 |
| Thymeleaf | サーバー側で HTML を作るテンプレート | 画面を返す Web アプリ |
| Spring Data JPA | JPA と Hibernate | データベースを使う |
| H2 Database | 約2MBのメモリ上のデータベース | 学習・テスト用の DB |
| Lombok | getter などを自動生成する注釈 | 定型コードを減らす |
| Spring Boot Actuator | 稼働状況を返すエンドポイント | ヘルスチェック・監視 |
Spring Data JPA を入れたら、データベースの接続先も必要です。 接続先が無いと起動しません(「よく出る起動エラーと直し方」の3つ目)。最初は Spring Web だけで始め、DB は後から足すと、原因の切り分けが楽になります。
Initializr は、選んだ starter ごとにテスト用の starter も自動で足します。Spring Web を選ぶと、pom.xml には spring-boot-starter-webmvc と、テスト用の spring-boot-starter-webmvc-test が入ります。
関連記事「Spring Boot starter一覧|用途別の選び方とBoot 4の新旧対応表」で扱っています。
作られるフォルダ構成
Maven・Spring Web を選んだときに、Initializr が作るファイルは次のとおりです(initializr のソースで確かめた構成)。
demo/
├── .gitattributes
├── .gitignore
├── .mvn/
│ └── wrapper/
│ └── maven-wrapper.properties
├── HELP.md
├── mvnw
├── mvnw.cmd
├── pom.xml
└── src/
├── main/
│ ├── java/com/example/demo/
│ │ └── DemoApplication.java
│ └── resources/
│ ├── application.properties
│ ├── static/
│ └── templates/
└── test/
└── java/com/example/demo/
└── DemoApplicationTests.java
| ファイル・フォルダ | 役割 |
|---|---|
pom.xml |
依存とビルドの設定(Gradle なら build.gradle) |
mvnw・mvnw.cmd |
Maven Wrapper。Maven を入れていなくても決まった版でビルドできる |
DemoApplication.java |
main メソッドを持つ起動クラス |
application.properties |
ポート番号などの設定。最初は spring.application.name=demo の1行 |
static/ |
画像・CSS・JS をそのまま返す場所 |
templates/ |
Thymeleaf などのテンプレートを置く場所 |
DemoApplicationTests.java |
アプリが起動できるかを確かめるテスト |
HELP.md |
選んだ依存の公式ガイドへのリンク集 |
Gradle を選ぶと、pom.xml・mvnw の代わりに build.gradle・settings.gradle・gradlew・gradlew.bat・gradle/wrapper/ が入ります。
pom.xml の中心は次の部分です(Spring Web・Java 21 を選んだ場合の抜粋)。
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>4.1.1</version>
</parent>
<groupId>com.example</groupId>
<artifactId>demo</artifactId>
<version>0.0.1-SNAPSHOT</version>
<properties>
<java.version>21</java.version>
</properties>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-webmvc</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-webmvc-test</artifactId>
<scope>test</scope>
</dependency>
</dependencies>
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
</plugins>
</build>
依存に <version> が無いのは、親の spring-boot-starter-parent が版を決めているからです。 Spring Boot 4.1.1 を選ぶと、Spring Framework 7.0.9・Tomcat 11.0.24・Jackson 3.1.5 などの版が自動で決まります。
コントローラーなどのクラスは、DemoApplication と同じパッケージか、その下に置きます。 @SpringBootApplication は、自分のパッケージから下だけを探して部品を登録します。外に置いたクラスは見つからず、404 になります(後の「よく出る起動エラーと直し方」で実例)。
関連記事「Spring Bootパッケージ構成|層別と機能別のツリーと選び方の基準」で扱っています。
最小のREST APIを作って動かす
ここからは、Initializr で作ったプロジェクトに2つのクラスを足して、実際に起動します。
起動クラス(Initializr が作ったまま)
package com.example.demo;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
@SpringBootApplication
public class DemoApplication {
public static void main(String[] args) {
SpringApplication.run(DemoApplication.class, args);
}
}
@SpringBootApplication は、次の3つをまとめた注釈です(公式ドキュメントでは「メタアノテーション」と呼びます)。
| 注釈 | 役割 |
|---|---|
@SpringBootConfiguration |
このクラスを設定クラスとして扱う |
@EnableAutoConfiguration |
依存の jar を見て自動設定を有効にする |
@ComponentScan |
このパッケージから下の @RestController などを探して登録する |
文字列を返すコントローラー
src/main/java/com/example/demo/HelloController.java を作ります。
package com.example.demo;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
@RestController
public class HelloController {
private final String greeting;
public HelloController(@Value("${app.greeting:Hello}") String greeting) {
this.greeting = greeting;
}
@GetMapping("/hello")
public String hello(@RequestParam(defaultValue = "World") String name) {
return greeting + ", " + name + "!";
}
}
@Value("${app.greeting:Hello}") は、application.properties の app.greeting を読み、無ければ Hello を使う書き方です。
JSON を返す・受け取るコントローラー
メモを登録・一覧・1件取得する API です。データはメモリ上の Map に持つので、再起動すると消えます。
package com.example.demo;
import java.util.List;
import java.util.Map;
import java.util.concurrent.ConcurrentHashMap;
import java.util.concurrent.atomic.AtomicLong;
import org.springframework.http.HttpStatus;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseStatus;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.server.ResponseStatusException;
@RestController
@RequestMapping("/api/memos")
public class MemoController {
private final Map<Long, Memo> memos = new ConcurrentHashMap<>();
private final AtomicLong nextId = new AtomicLong(1);
@GetMapping
public List<Memo> list() {
return List.copyOf(memos.values());
}
@GetMapping("/{id}")
public Memo get(@PathVariable long id) {
Memo memo = memos.get(id);
if (memo == null) {
throw new ResponseStatusException(HttpStatus.NOT_FOUND, "memo " + id + " not found");
}
return memo;
}
@PostMapping
@ResponseStatus(HttpStatus.CREATED)
public Memo create(@RequestBody MemoRequest request) {
long id = nextId.getAndIncrement();
Memo memo = new Memo(id, request.text());
memos.put(id, memo);
return memo;
}
public record MemoRequest(String text) {
}
public record Memo(long id, String text) {
}
}
Java の record(値を持つだけのクラスを短く書く構文、Java 16 から)を返すと、Spring Boot が Jackson で JSON に変換します。JSON 用の設定は書いていません。
| 注釈 | 意味 |
|---|---|
@RestController |
戻り値をそのまま応答の本文にするコントローラー |
@RequestMapping("/api/memos") |
このクラスのすべての URL の先頭 |
@GetMapping・@PostMapping |
GET・POST を受けるメソッド |
@PathVariable |
URL の {id} の部分を受け取る |
@RequestParam |
?name=… のクエリを受け取る |
@RequestBody |
本文の JSON をオブジェクトに変換して受け取る |
@ResponseStatus(HttpStatus.CREATED) |
成功時のステータスを 201 にする |
起動する
プロジェクトのフォルダで次のコマンドを実行します。
# Maven(Mac・Linux)
./mvnw spring-boot:run
# Maven(Windows の PowerShell)
.\mvnw.cmd spring-boot:run
# Gradle
./gradlew bootRun
IntelliJ IDEA・Eclipse・VS Code では、DemoApplication の main メソッドを実行しても起動します。
実際の起動ログです。ポートは application.properties の server.port=25700 で変えています(既定は 8080)。行の途中は「…」で省きました。
. ____ _ __ _ _
/\\ / ___'_ __ _ _(_)_ __ __ _ \ \ \ \
( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \
\\/ ___)| |_)| | | | | || (_| | ) ) ) )
' |____| .__|_| |_|_| |_\__, | / / / /
=========|_|==============|___/=/_/_/_/
:: Spring Boot :: (v4.1.1)
… INFO 22638 --- [demo] [main] com.example.demo.DemoApplication : Starting DemoApplication using Java 21.0.10 with PID 22638 (…)
… INFO 22638 --- [demo] [main] com.example.demo.DemoApplication : No active profile set, falling back to 1 default profile: "default"
… INFO 22638 --- [demo] [main] o.s.boot.tomcat.TomcatWebServer : Tomcat initialized with port 25700 (http)
… INFO 22638 --- [demo] [main] o.apache.catalina.core.StandardService : Starting service [Tomcat]
… INFO 22638 --- [demo] [main] o.apache.catalina.core.StandardEngine : Starting Servlet engine: [Apache Tomcat/11.0.24]
… INFO 22638 --- [demo] [main] b.w.c.s.WebApplicationContextInitializer : Root WebApplicationContext: initialization completed in 1084 ms
… INFO 22638 --- [demo] [main] o.s.boot.tomcat.TomcatWebServer : Tomcat started on port 25700 (http) with context path '/'
… INFO 22638 --- [demo] [main] com.example.demo.DemoApplication : Started DemoApplication in 2.072 seconds (process running for 2.358)
Tomcat started on port … と Started DemoApplication in … が出れば、起動は成功です。 [demo] は spring.application.name の値です。止めるときは、ターミナルで Ctrl+C を押します。
curl で呼んだ結果
別のターミナルから curl(コマンドで HTTP を送るツール)で呼びました。ブラウザで http://localhost:25700/hello を開いても同じ文字列が表示されます。
curl -i "http://localhost:25700/hello?name=Spring"
HTTP/1.1 200
Content-Type: text/plain;charset=UTF-8
Content-Length: 14
Date: Fri, 16 Oct 2026 23:24:26 GMT
Hello, Spring!
JSON を POST して登録し、一覧と1件を取り出します。
curl -i -X POST http://localhost:25700/api/memos \
-H 'Content-Type: application/json' \
-d '{"text":"牛乳を買う"}'
HTTP/1.1 201
Content-Type: application/json
Content-Length: 33
Date: Fri, 16 Oct 2026 23:17:09 GMT
{"id":1,"text":"牛乳を買う"}
curl http://localhost:25700/api/memos
[{"id":1,"text":"牛乳を買う"},{"id":2,"text":"本を返す"}]
存在しない id を指定すると、Spring Boot の既定のエラー応答(JSON)が返りました。
HTTP/1.1 404
Content-Type: application/json
Transfer-Encoding: chunked
Date: Fri, 16 Oct 2026 23:17:09 GMT
{"timestamp":"2026-10-16T23:17:09.727Z","status":404,"error":"Not Found","path":"/api/memos/99"}
ResponseStatusException に渡した "memo 99 not found" は、既定では応答に入りません。間違ったリクエストも送って、返るステータスを確かめました。
| 送ったリクエスト | ステータス | ログの WARN(Resolved の中身) |
|---|---|---|
GET /api/memos/99(無い id) |
404 | ― |
| 壊れた JSON を POST | 400 | HttpMessageNotReadableException: JSON parse error: Unexpected end-of-input … |
| Content-Type がフォーム形式で POST | 415 | Content-Type 'application/x-www-form-urlencoded;charset=UTF-8' is not supported |
GET /api/memos/abc(数字でない) |
400 | Failed to convert value of type 'java.lang.String' to required type 'long' |
DELETE /api/memos/1(未定義) |
405 | Request method 'DELETE' is not supported |
| 何も無い URL をブラウザで開く | 404 | ―(画面は Whitelabel Error Page) |
ブラウザ(Accept: text/html)で何も無い URL を開くと、JSON ではなく HTML(Content-Length: 275)が返り、画面には次の文字が表示されました。
Whitelabel Error Page
This application has no explicit mapping for /error, so you are seeing this as a fallback.
Sat Oct 17 08:14:17 JST 2026
There was an unexpected error (type=Not Found, status=404).
関連記事「Spring Boot Whitelabel Error Pageの原因と直し方」で扱っています。入力チェック・エラー応答の作り込み・テストは、関連記事「Spring BootでREST APIを作る|入力チェック・エラー処理・テストまで」で扱っています。
エラーのときに返すステータスコードの使い分け
失敗の理由ごとにコードを分けます。500 は想定外の失敗だけに使い、入力や業務の失敗は 4xx、一時的に使えないときは 503 にします。 上の表の 400・404・405・415 は、自分でコードを書かなくても Spring が返したものです。
| 状況 | 返すコード | Spring での書き方の一言 |
|---|---|---|
| 入力の誤り(壊れた JSON・型違い) | 400 | Spring が自動で返す(上の表で確認) |
| 指定した id が無い | 404 | ResponseStatusException(HttpStatus.NOT_FOUND, …) |
| ログインしていない | 401 | Spring Security の AuthenticationEntryPoint |
| ログイン済みだが権限が無い | 403 | Spring Security の AccessDeniedHandler |
| 二重登録・状態の食い違い | 409 | ResponseStatusException(HttpStatus.CONFLICT, …) |
| メソッド・Content-Type が違う | 405・415 | Spring が自動で返す(上の表で確認) |
| 一時的に使えない(メンテナンス・DB 停止) | 503 + Retry-After |
ResponseEntity.status(503).header(HttpHeaders.RETRY_AFTER, "30") |
| 想定外の例外 | 500 | 捕まえなかった例外は Spring が 500 にする |
業務の失敗(在庫切れ・二重登録・権限なし)まで 500 にしないことが要点です。500 は「サーバーの不具合」という意味なので、呼び出し側は直しようがなく、再試行してよいかも分かりません。URL ごとに認可を決める設定では、401・403 は Spring Security のフィルターがコントローラーより前で返すため、コントローラーの例外処理(@ExceptionHandler)では受け取れません。
@RestControllerAdvice でまとめて返し分ける完成コードと、エラー応答を RFC 9457 の ProblemDetail 形式(spring.mvc.problemdetails.enabled=true)にそろえる方法は、関連記事「Spring Boot 例外処理|ステータスコードの返し分けと503実例」で扱っています。503 と Retry-After の意味と、受け取る側がどう待つかは、関連記事「504 Gateway Time-outの原因と直し方|502・503との違いと実例」で扱っています。
実行可能jarを作る
配布や本番では、jar にまとめて java -jar で起動します。公式チュートリアルの手順です。
# Maven
./mvnw package
java -jar target/demo-0.0.1-SNAPSHOT.jar
# Gradle
./gradlew bootJar
java -jar build/libs/demo-0.0.1-SNAPSHOT.jar
公式ドキュメントによると、Maven では元の小さな jar が demo-0.0.1-SNAPSHOT.jar.original として残ります。依存を中に入れた jar(fat jar)は、spring-boot-maven-plugin が作り直したものです。
application.propertiesの書き方
application.properties は、キー=値 を1行ずつ書く設定ファイルです。 src/main/resources/ に置くと、起動時に自動で読まれます。
spring.application.name=demo
server.port=25700
app.greeting=Hello
server.port のように Spring Boot が決めているキーと、app.greeting のように自分で決めたキーを同じファイルに書けます。
| キー | 意味 | 例 |
|---|---|---|
server.port |
待ち受けるポート。既定 8080 | server.port=8081 |
spring.application.name |
アプリ名。ログの [demo] に出る |
spring.application.name=demo |
server.servlet.context-path |
URL の先頭に付けるパス | server.servlet.context-path=/app |
logging.level.<パッケージ> |
ログの細かさ | logging.level.org.springframework.web=DEBUG |
spring.profiles.active |
使うプロファイル | spring.profiles.active=dev |
spring.datasource.url |
DB の接続先 | spring.datasource.url=jdbc:h2:mem:testdb |
環境ごとに切り替える(プロファイル)
application-<名前>.properties を作ると、その名前のプロファイルを有効にしたときだけ読まれます。application-dev.properties に次を書きました。
server.port=25702
app.greeting=Hi (dev)
logging.level.org.springframework.web=DEBUG
起動時に --spring.profiles.active=dev を付けると、ログと応答が次のように変わりました。
… INFO … : The following 1 profile is active: "dev"
… INFO … : Tomcat started on port 25702 (http) with context path '/'
… DEBUG … s.w.s.m.m.a.RequestMappingHandlerMapping : Mapped to com.example.demo.HelloController#hello(String)
… DEBUG … o.s.web.servlet.DispatcherServlet : Completed 200 OK
$ curl localhost:25702/hello
Hi (dev), World!
公式ドキュメントでは、プロファイル別のファイルは共通のファイルより優先され、コマンドライン引数(--server.port=9090 など)はファイルより優先されます。同じ場所に .properties と YAML(application.yaml)の両方があるときは .properties が優先されるので、どちらか一方にそろえます。
日本語を書くと文字化けする
app.greeting=こんにちは を UTF-8 で保存して起動すると、応答は次のように化けました。
ããã«ã¡ã¯, World!
Spring Boot は application.properties を ISO-8859-1 として読みます(OriginTrackedPropertiesLoader のソースで、文字コードの指定が無いときの既定が ISO-8859-1)。\u で書くと化けません。
app.greeting=こんにちは
$ curl localhost:25715/hello
こんにちは, World!
公式ドキュメントには、spring.config.import で読み込むファイルに [encoding=utf-8] を付けると UTF-8 で読める書き方も載っています。日本語の値が多いときは、YAML 形式を選ぶ方法もあります。
関連記事「Spring Boot application.properties設定一覧」で扱っています。
よく出る起動エラーと直し方
起動に失敗すると、ログの最後に APPLICATION FAILED TO START と、原因(Description)・対処(Action)が出ます。 長いスタックトレースより先に、この2つを読みます。どれも実際に起こした原文です。
| エラー原文(要点) | 原因 | 直し方 |
|---|---|---|
Port 8080 was already in use. |
同じポートを別のプロセスが使っている | 前に起動したアプリを止めるか、server.port を変える |
required a bean of type '…' that could not be found. |
@Service などの付け忘れ、探す範囲の外 |
注釈を付ける。起動クラスの下のパッケージに置く |
Failed to configure a DataSource: 'url' attribute is not specified |
JPA・JDBC を入れたのに DB の設定が無い | spring.datasource.url を書くか H2 を足す |
Ambiguous mapping. Cannot map 'helloController' method |
同じ URL と HTTP メソッドが2つある | どちらかの URL かメソッドを変える |
Failed to bind properties under 'server.port' |
数字の所に全角や文字が入っている | 半角の数字にする |
no …ServletWebServerFactory bean defined |
@SpringBootApplication が無い、Web の starter が無い |
注釈と依存を確かめる |
UnsupportedClassVersionError … (class file version 61.0) |
Java 11 以前で起動している | Java 17 以上で起動する |
| 起動するが 404 になる | コントローラーが起動クラスより外のパッケージ | 起動クラスと同じか下のパッケージへ移す |
日本語の設定値が ã… に化ける |
properties を ISO-8859-1 で読んでいる | こ の形で書く、YAML にする |
Port 8080 was already in use
起動したままのアプリがあるのに、もう一度起動すると出ます。同じポート(25700)で2つ目を起動したときの原文です。
***************************
APPLICATION FAILED TO START
***************************
Description:
Web server failed to start. Port 25700 was already in use.
Action:
Identify and stop the process that's listening on port 25700 or configure this application to listen on another port.
IDE で起動したアプリが裏で動き続けていることがよくあります。使っているプロセスは、Mac・Linux では lsof -i :8080、Windows では netstat -ano | findstr :8080 で探せます。
required a bean of type … that could not be found
コントローラーのコンストラクタで受け取る GreetingService に、@Service を付け忘れたときの原文です。
Description:
Parameter 0 of constructor in com.example.demo.HelloController required a bean of type 'com.example.demo.GreetingService' that could not be found.
Action:
Consider defining a bean of type 'com.example.demo.GreetingService' in your configuration.
Spring が管理する部品(Bean)にするには、クラスに @Service・@Component・@Repository などを付けます。付けているのに出るときは、そのクラスが起動クラスより外のパッケージにあります。
Failed to configure a DataSource
Initializr で Spring Data JPA や JDBC を選び、接続先を書かずに起動したときの原文です。入門でいちばん多く見るエラーの1つです。
Description:
Failed to configure a DataSource: 'url' attribute is not specified and no embedded datasource could be configured.
Reason: Failed to determine a suitable driver class
Action:
Consider the following:
If you want an embedded database (H2, HSQL or Derby), please put it on the classpath.
If you have database settings to be loaded from a particular profile you may need to activate it (no profiles are currently active).
直し方は3通りです。学習中なら Initializr で H2 Database を足す。使う DB が決まっているなら spring.datasource.url・username・password を書く。まだ DB を使わないなら、JPA・JDBC の依存を外す。
Ambiguous mapping
同じクラスに @GetMapping("/hello") を2つ書いたときの原文です。
Caused by: java.lang.IllegalStateException: Ambiguous mapping. Cannot map 'helloController' method
com.example.demo.HelloController#hello2()
to {GET [/hello]}: There is already 'helloController' bean method
com.example.demo.HelloController#hello() mapped.
別のクラスどうしでも、同じ URL・同じ HTTP メソッドなら同じエラーになります。
Failed to bind properties under 'server.port'
server.port=8080 のように全角の「8」が混ざったときの原文です。文字化けして見えるのは、上で書いたとおり ISO-8859-1 で読まれているためです。
Description:
Failed to bind properties under 'server.port' to java.lang.Integer:
Property: server.port
Value: "80ï¼0"
Origin: class path resource [application.properties] - 2:13
Reason: failed to convert java.lang.String to java.lang.Integer (caused by java.lang.NumberFormatException: For input string: "80ï¼0")
Action:
Update your application's configuration
Origin の 2:13 は、ファイルの2行目・13文字目を表します。
no ServletWebServerFactory bean defined
起動クラスから @SpringBootApplication を消したときの原文です。
Description:
Web application could not be started as there was no org.springframework.boot.web.server.servlet.ServletWebServerFactory bean defined in the context.
Action:
Check your application's dependencies for a supported servlet web server.
Check the configured web application type.
自動設定が働かないため、Tomcat が用意されません。注釈が付いているのに出るときは、spring-boot-starter-webmvc(Spring Web)が依存に入っているかを確かめます。
起動するのに 404 になる
HelloController を com.example.web パッケージに移すと、起動は成功するのに /hello が404になりました。
HTTP/1.1 404
{"timestamp":"2026-10-16T23:16:42.644Z","status":404,"error":"Not Found","path":"/hello"}
起動クラスが com.example.demo にあるため、com.example.web は探す範囲の外です。com.example.demo.web のように、起動クラスのパッケージの下へ移します。
起動しないときに確かめる順番
- 1ログの最後に APPLICATION FAILED TO START があるかある → Description と Action を読む。上の表で原因が分かることが多い
- 2java -version が 17 以上か16 以下 → UnsupportedClassVersionError。IDE のプロジェクト設定の JDK も確かめる
- 3クラスが起動クラスと同じか下のパッケージにあるか外にある → Bean が見つからない・404 になる
- 4使っていない starter(JPA など)が入っていないか入っている → その starter が求める設定(DB の URL など)が要る
- 5--debug を付けて起動し、自動設定の判定を見たかCONDITIONS EVALUATION REPORT に、どの自動設定が効いたか・効かなかったかが出る
起動に失敗すると、ログに To display the condition evaluation report re-run your application with 'debug' enabled. と出ます。--debug を付けて起動すると、自動設定ごとに効いた理由が出ます。
DispatcherServletAutoConfiguration matched:
- @ConditionalOnClass found required class 'org.springframework.web.servlet.DispatcherServlet' (OnClassCondition)
- found 'session' scope (OnWebApplicationCondition)
「DispatcherServlet のクラスがあったので、Web の受付役を自動で用意した」という意味です。自動設定は、この判定の積み重ねで動いています。
よくある質問
Q. spring bootとは何ですか? A. Java の Spring Framework を、設定済みの状態ですぐ動かせるようにする仕組みです。自動設定・starter・組み込み Tomcat・実行可能 jar の4つが中心です。詳しくは「Spring Bootとは」にあります。
Q. springboot と Spring Boot は同じものですか? A. 同じものです。正式な表記は「Spring Boot」で、検索では続けて書かれることがあります。
Q. spring initializrとは何ですか? A. Spring Boot プロジェクトのひな形を作る公式の Web サービス(start.spring.io)です。各項目の意味は「画面の各項目の意味」の表にあります。
Q. spring boot 入門は何から始めればよいですか? A. Java 17 以上を入れ、Initializr で Spring Web だけを選んだプロジェクトを作り、コントローラーを1つ足して起動するところからです。この記事の「最小のREST APIを作って動かす」の順に進められます。
Q. Spring Bootの最新版と、必要なJavaの版は? A. 2026年10月17日時点の最新の安定版は 4.1.1 で、Java 17 以上が必要です(26 まで対応)。4.1.x の OSS サポートは 2027年7月31日までです。
Q. Spring Bootは無料で使えますか? A. 使えます。Apache License 2.0 のオープンソースです。
まとめ
- Spring Boot は、Spring Framework を自動設定・starter・組み込み Tomcat で「すぐ動く形」にする仕組み。
- 2026年10月17日時点の最新は 4.1.1。Java 17 以上が必要で、Java 11 では
UnsupportedClassVersionErrorで止まった。 - Spring Initializr は迷ったら Maven・Java・4.1.1・Jar・Java 21 か 25・Spring Web で始める。
- コントローラーは起動クラスと同じか下のパッケージに置く。外に置くと Bean が見つからない・404 になる。
- application.properties は ISO-8859-1 で読まれ、日本語は化けた。
\uで書くか YAML にする。 - 起動しないときは
APPLICATION FAILED TO STARTの Description と Action を先に読む。
参考・出典
確認日はいずれも 2026年10月17日です。
- Spring「Spring Boot」:https://spring.io/projects/spring-boot
- Spring Boot「System Requirements」:https://docs.spring.io/spring-boot/system-requirements.html
- Spring Boot「Developing Your First Spring Boot Application」:https://docs.spring.io/spring-boot/tutorial/first-application/index.html
- Spring Boot「Externalized Configuration」:https://docs.spring.io/spring-boot/reference/features/external-config.html
- Spring Boot「Spring Boot 4.0 Migration Guide」:https://github.com/spring-projects/spring-boot/wiki/Spring-Boot-4.0-Migration-Guide
- Spring「Spring Boot のサポート期限(generations API)」:https://api.spring.io/projects/spring-boot/generations
- Spring Initializr:https://start.spring.io
- Spring Initializr のメタデータ:https://start.spring.io/metadata/client
- GitHub「spring-io/start.spring.io」:https://github.com/spring-io/start.spring.io
- GitHub「spring-io/initializr」:https://github.com/spring-io/initializr
- GitHub「spring-projects/spring-boot」(タグ v4.1.1):https://github.com/spring-projects/spring-boot
- GitHub「spring-projects/spring-framework」(タグ v7.0.9):https://github.com/spring-projects/spring-framework
本記事の内容は、ご自由にお使いください。
ご利用の際は、出典として本ページへのリンクを記載いただけますようお願いします。
(記載例)出典:株式会社RJC「Spring Bootとは|入門・Initializrの使い方とREST API作成」
株式会社RJC ― SI事業・SES事業・AI駆動開発。RJCは一緒に成長を楽しめる会社です。
WE ARE HIRING
RJCで一緒に開発しながら、
成長を楽しみませんか?
RJCは、Web・モバイル・AIを活用した開発プロジェクトで、テックリードやPM・PMOも活躍するシステム開発会社です。会社を知る、待遇を確かめる、話を聞いてみる。気になるところ見てみてください!
- 127日年間休日
- 12時間平均残業時間
- 毎日ガチャ遊びココロも大切にする福利厚生。アマギフなどの賞品ラインナップ!
ほかにも、チケットレストラン、書籍読み放題、2年ごとの慰労報奨(休暇 or 金一封)、11期連続の黒字決算。