はじめに
Spring Boot を使っていると、
「アプリが起動しない…」
という瞬間に必ず出会います。
- 何が原因なのか分からない
- ログが長すぎて読めない
- どこから調べればいいのか迷う
こういった不安は、
“見るべき場所” を知るだけで一気に解消します。
この記事では、Spring Boot が起動しないときに
最初に確認すべきポイント を
やさしく・実務寄り で整理していきます。
起動しないときに見る場所（全体像）
1. 起動ログ（最重要）
2. エラーメッセージの「原因（Caused by）」
3. ポートの競合
4. Bean の登録エラー
5. 設定ファイル（application.yml / properties）
6. 依存関係（pom.xml / build.gradle）
7. DB 接続設定
8. キャッシュ・ビルドの破損
この順番で見ていくと、
ほとんどの問題は解決できます。
起動ログ（最重要）
まずは ログの一番下 を見ます。
Spring Boot のエラーは
最後の数行に本当の原因が書かれている
ことが多いです。
APPLICATION FAILED TO START
この下に原因が書かれています。
Caused by を探す（真犯人）
ログが長いときは、 「Caused by」 を検索します。
例：
Caused by: java.lang.IllegalStateException: Failed to load ApplicationContext
この行が “真犯人” です。
ポートの競合
Spring Boot はデフォルトで 8080 を使います。
よくあるエラー
Port 8080 is already in use
対策
- 他のアプリを終了する
- ポートを変更する
server:
port: 8081Bean の登録エラー
Spring で最も多い原因です。
よくあるエラー
NoSuchBeanDefinitionException
UnsatisfiedDependencyException
原因
- @Service / @Component の付け忘れ
- パッケージがスキャン範囲外
- @Autowired の対象が複数ある
対策
- アノテーションを付ける
- Application 配下にパッケージを置く
- @Qualifier を使う
application.yml / properties のミス
設定ファイルのミスは起動エラーの定番です。
よくあるミス
- インデントがずれている（YAML）
- コロンの後にスペースがない
- 型が違う
- プロファイルが間違っている
例
spring:
datasource:
url: jdbc:mysql://localhost:3306/test依存関係（pom.xml / build.gradle）
依存関係の競合や不足もよくあります。
よくあるエラー
ClassNotFoundException
NoClassDefFoundError
対策
- 依存関係を追加する
- バージョンを揃える
mvn clean install/gradle clean build
DB 接続設定
DB が起動していない、 または接続情報が間違っていると起動しません。
よくあるエラー
Cannot create PoolableConnectionFactory
対策
- DB が起動しているか確認
- URL / ユーザー / パスワードを確認
- ドライバの依存を追加
キャッシュ・ビルドの破損
まれにビルドキャッシュが壊れていることがあります。
対策
mvn clean
gradle clean
IDE のキャッシュ削除も有効です。
実務でよくある原因まとめ
アノテーションの付け忘れ
@Service / @Component / @Repository
パッケージが Application 配下にない
ComponentScan の範囲外。
application.yml のミス
インデント・スペル・型。
DB 接続エラー
URL / 認証情報。
ポート競合
8080 が埋まっている。
起動しないときの“黄金ルール”
ログの一番下を見る
原因は最後に書いてある。
Caused by を探す
真犯人が分かる。
「設定」「Bean」「依存」の順に疑う
ほとんどはこの 3 つ。
まとめ
Spring Boot が起動しないときは、
「ログ → Caused by → 設定 → Bean → 依存」
の順に見ていくと解決できます。
- ログの最後を見る
- Caused by を探す
- ポート競合
- Bean の登録エラー
- application.yml のミス
- 依存関係の不足
- DB 接続エラー
難しく聞こえますが、
「ログの最後を見る」
だけで 7 割は解決できます。
起動しない瞬間は不安になりますが、
“見るべき場所” を知っているだけで、
落ち着いて原因を特定できるようになります。
あなたの開発が、今日より少しだけ楽になりますように。
困ったときは“最後のログ”を見るんだね…
落ち着いて調べれば大丈夫だよ。
コメント