結論

Spring Bootは、Spring Frameworkを設定済みの状態ですぐ動かせるようにする仕組みです。Webサーバーも中に入っていて、mainメソッドから起動できます。

この記事でわかること

  • Spring Initializrの全7項目の意味と選び方
  • REST APIの起動ログとcurlで呼んだ応答7種
  • 起動エラー9種の原文・原因・直し方の表

2026年10月17日更新|Spring Boot 4.1.1・Java 21 で起動確認

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 を呼び出せます。

1

start.spring.io を開き、Project と Language を選ぶ

迷ったら Maven と Java。学習用の記事や本は Maven の例が多めです。

2

Spring Boot の版を選ぶ

SNAPSHOT・M2 が付いていない版(2026年10月17日時点は 4.1.1)を選びます。

3

Project Metadata を入力する

Group・Artifact・Package name・Packaging・Configuration・Java を決めます(下の表)。

4

Add dependencies で Spring Web を追加する

REST API を作るなら Spring Web だけで始められます。

Windows は Ctrl+B、Mac は ⌘+B

5

Generate で zip をダウンロードし、展開する

Explore を押すと、ダウンロード前に中身のファイルを画面で見られます。

Generate は Ctrl+Enter(Mac は ⌘+Enter)、Explore は Ctrl+Space

画面の各項目の意味

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期連続の黒字決算。

ABOUT RJC RJCがどんな会社か知る 考え方、研修、働き方、福利厚生、社員の前職まで。RJCのことが丸わかり! RJC丸わかりページへ JOB DESCRIPTION 仕事内容・待遇を見てみる 仕事内容、給与・待遇、選考の流れ。経験者も未経験も!応募前に知りたいこと、まとめました! 募集要項を見る ENTRY エントリーする エントリーは1〜2分・履歴書不要です。まずは話を聞いてみたい、という方でも歓迎です! エントリーフォームへ

成長のヒミツ、 ぜんぶ丸わかり