Eclipse上のJavaコードでブレークポイントを置けなくなるケースとは？Spring Boot開発の新人エンジニア向けに解説

こんにちは。ゆうせいです。

今回は、Eclipse上のJavaコードで「本来ならブレークポイントを置けるはずなのに、置けなくなっている」ケースについて解説します。

Spring Bootで開発していると、ControllerやServiceやDAOの行にブレークポイントを置いて、処理を止めながら確認することがありますよね。

ところが、ある日突然、左側の余白をダブルクリックしてもブレークポイントが付かない。

ブレークポイントを置いたつもりなのに、処理が止まらない。

丸い印は付いているのに、実行時に無視される。

このようなことがあります。

原因はいくつかありますが、大きく分けると次の4種類です。

Eclipseのデバッグ機能では、ブレークポイントはEclipseのブレークポイント管理機能によって管理されます。Eclipse公式ヘルプでも、ブレークポイントはBreakpoint Managerによって追加・削除され、全体として有効・無効を切り替えられると説明されています。

つまり、ブレークポイントは単なる画面上の丸印ではありません。

Eclipse、Javaのコンパイル結果、起動中のJVM、実行されるソースコードが正しくつながって初めて機能します。

まず確認すべき結論

最初に、よくある原因を結論としてまとめます。

新人エンジニアは、いきなり難しい設定を見る前に、まず「Debug起動しているか」「その行は本当に実行されているか」「ブレークポイント全体が無効になっていないか」を確認してください。

ケース1：DebugではなくRunで起動している

一番よくあるのが、Spring BootアプリをDebugではなくRunで起動しているケースです。

Eclipseには、通常実行とデバッグ実行があります。

Spring Bootなら、次のように起動します。

プロジェクトを右クリック
Debug As
Spring Boot App

または、mainメソッドがあるクラスを右クリックして、次のように起動します。

Debug As
Java Application

Run Asで起動している場合、Eclipse上にブレークポイントの丸印が付いていても、処理は止まりません。

たとえるなら、監視カメラを設置したけれど録画モードにしていないようなものです。

カメラはそこにあります。

でも、記録も停止もできません。

ケース2：Skip All Breakpointsが有効になっている

Eclipseには、すべてのブレークポイントを一時的に無視する機能があります。

英語ではSkip All Breakpointsです。

この機能がオンになっていると、ブレークポイントを置いていても止まりません。

BreakpointsビューやDebugビュー周辺に、ブレークポイントをすべてスキップするボタンがあります。

新人エンジニアが知らないうちにクリックしてしまい、「ブレークポイントが効かない！」となることがあります。

Breakpointsビューを開いて、全体無効になっていないか確認してください。

Eclipse公式ヘルプでも、ブレークポイントの有効・無効はBreakpoint Managerによって制御できると説明されています。

たとえるなら、赤信号を全部無効にするスイッチが入っている状態です。

交差点ごとの信号は存在します。

でも、全体スイッチで「信号を使わない」設定になっているので止まりません。

ケース3：個別のブレークポイントが無効になっている

全体ではなく、個別のブレークポイントだけが無効になっている場合もあります。

この場合、ブレークポイントの丸に斜線が入っていたり、Breakpointsビューでチェックが外れていたりします。

確認手順です。

Window
Show View
Breakpoints

または、DebugパースペクティブでBreakpointsビューを表示します。

対象のブレークポイントにチェックが入っているか確認しましょう。

ケース4：実行されない行に置こうとしている

Javaでは、ブレークポイントを置ける行と置けない行があります。

基本的に、実行可能なコード行に置きます。

悪い例です。

// 車一覧を表示する処理

コメント行は実行されません。

ブレークポイントを置いても意味がありません。

良い例です。

List<CarDto> carList = carsDao.findAll();

このような実行される行に置きます。

たとえるなら、電車を止めたいなら線路上に停止位置を作る必要があります。

駅の案内板やポスターに停止位置を作っても、電車は止まりません。

ケース5：その処理がそもそも呼ばれていない

ブレークポイントは置けている。

Debug起動もしている。

それでも止まらない。

この場合、そもそもそのメソッドが呼ばれていない可能性があります。

Spring Bootでは、URL、HTTPメソッド、Controllerのマッピングが少し違うだけで、想定したメソッドに入りません。

例を見てください。

@GetMapping("/cars/search")
public String search() {
    System.out.println("検索処理です");
    return "cars/search";
}

このメソッドにブレークポイントを置いているとします。

しかし、ブラウザで次のURLにアクセスしていたらどうでしょうか。

/car/search

carsではなくcarです。

この場合、別のURLなので、このメソッドは呼ばれません。

また、GETとPOSTの違いでも呼ばれません。

@PostMapping("/cars/search")
public String searchPost() {
    return "cars/search";
}

このメソッドはPOST用です。

ブラウザでURLを直接入力してGETアクセスしても、このメソッドには入りません。

切り分けのために、メソッド先頭に一時的にログを入れてみましょう。

System.out.println("searchメソッドに入りました");

このログが出ないなら、ブレークポイント以前に、そのメソッドが呼ばれていません。

ケース6：ソースコードと実行中のclassファイルがずれている

Eclipseで表示しているJavaファイルと、実際にJVMで動いているclassファイルがずれていると、ブレークポイントが効かなかったり、変な行で止まったりします。

Javaは、.javaファイルをそのまま実行しているわけではありません。

.javaをコンパイルして、.classファイルにしてから実行します。

Oracleのjavacドキュメントでも、javacはJavaソースファイルを読み取り、Java Virtual Machineで実行されるクラスファイルへコンパイルすると説明されています。

つまり、Eclipseで見ている.javaと、実際に動いている.classが一致していないと、ブレークポイントが正しく動きません。

よくある原因です。

この場合は、次の操作を試します。

Project
Clean

そして、対象プロジェクトを選んで再ビルドします。

Mavenプロジェクトなら、次の操作も有効です。

プロジェクトを右クリック
Maven
Update Project

Spring Bootアプリを一度停止し、再度Debug起動することも大切です。

古いアプリが裏で動き続けていると、いくらEclipseで修正しても反映されません。

ケース7：コンパイル時に行番号のデバッグ情報が入っていない

Javaのブレークポイントは、ソースコードの行番号とclassファイル内のデバッグ情報を使って対応します。

コンパイル時に行番号情報が含まれていないと、Eclipseが「このソースのこの行で止める」と判断しにくくなります。

javacにはデバッグ情報を制御する-gオプションがあります。IBMのJavaビルドツール向けドキュメントでは、Ant、Maven、Gradleでsource、lines、varsといったデバッグ情報を含める設定例が紹介されています。

ブレークポイント関連で重要なのは、特にlines、つまり行番号情報です。

通常、EclipseやMavenで普通に開発している場合はデバッグ情報が含まれることが多いです。

しかし、特殊なビルド設定、外部jar、難読化、最適化、古いclassファイルなどでは、行番号情報がない場合があります。

その場合、次のようなメッセージに出会うことがあります。

Unable to install breakpoint due to missing line number attributes

この場合は、ビルド設定でデバッグ情報が含まれているか確認します。

ケース8：ライブラリやjarの中のコードを見ている

Eclipseでは、依存ライブラリのソースを開けることがあります。

たとえば、Spring Frameworkや外部ライブラリのクラスです。

しかし、ソースが表示されているからといって、必ずその場所に自由にブレークポイントを置けるとは限りません。

理由はいくつかあります。

新人エンジニアは、まず自分が書いたController、Service、DAOにブレークポイントを置いて確認してください。

Spring内部やライブラリ内部にいきなり入ると、かえって混乱しやすいです。

ケース9：同じクラス名が複数ある

プロジェクト内や依存関係に、同じようなクラス名が複数あると、違うファイルにブレークポイントを置いている可能性があります。

たとえば、次のようなケースです。

com.example.demo.controller.CarController

com.example.test.controller.CarController

または、古いパッケージと新しいパッケージの両方が残っている場合です。

名前が同じでも、パッケージが違えば別クラスです。

双子のように見えても、別人です。

片方に声をかけても、もう片方は反応しません。

ケース10：Spring Boot DevToolsや自動再起動で混乱している

Spring Boot DevToolsを使っている場合、コード変更時にアプリが自動再起動されることがあります。

便利な機能ですが、デバッグ時には次のような混乱が起きることがあります。

このような場合は、一度Spring Bootアプリを完全に停止します。

Consoleビューで赤い停止ボタンを押し、起動中のJavaプロセスが残っていないか確認します。

そのうえで、再度Debug Asで起動してください。

ケース11：ホットコード置換に失敗している

デバッグ中にJavaコードを修正すると、Eclipseが実行中のJVMへ変更を反映してくれる場合があります。

この機能は、Hot Code ReplaceやHotSwapのように呼ばれます。

しかし、すべての変更が反映できるわけではありません。

Eclipse JDT Debugは、Java VMをRunまたはDebugで起動したり、実行中のVMへ接続したり、VMが対応している場合に動的なクラス再読み込みを行う機能を持つと説明されています。

ホットコード置換に失敗しているのに、アプリを再起動していない場合、ブレークポイントの位置や実行コードが期待とずれることがあります。

迷ったら、再起動です。

開発中に困ったときの基本は、「保存、Clean、再ビルド、再Debug起動」です。

ケース12：ブレークポイントを置きたい場所がラムダ式やメソッドチェーンの途中

Javaのラムダ式やメソッドチェーンでは、見た目の1行に複数の処理が詰まっていることがあります。

carList.stream()
        .filter(car -> car.getPrice() >= 2000000)
        .map(car -> car.getName())
        .forEach(name -> System.out.println(name));

このようなコードでは、どこにブレークポイントを置くかによって止まり方がわかりにくくなる場合があります。

新人エンジニアのうちは、デバッグしやすいように一時的に分けて書くのもおすすめです。

for (CarDto car : carList) {

    if (car.getPrice() >= 2000000) {

        String name = car.getName();

        System.out.println(name);
    }
}

このように書くと、if文、getName、printlnの各行にブレークポイントを置きやすくなります。

かっこいいコードより、デバッグしやすいコードのほうが新人には大切な場面があります。

ケース13：匿名クラスや自動生成コードを見ている

Lombok、MapStruct、JPAのプロキシ、Springの自動生成クラスなどが絡むと、見えているソースと実際に動いているコードの関係がわかりにくくなることがあります。

たとえば、Lombokの@Getterや@Setterを使うと、ソースコード上にはgetterやsetterが見えません。

@Getter
@Setter
public class CarDto {

    private int carId;
    private String name;
    private int price;
}

実際にはコンパイル時にgetterやsetterが生成されます。

このような自動生成されたコードに対して、通常のJavaソースと同じ感覚でブレークポイントを置こうとすると混乱することがあります。

新人エンジニアの学習段階では、まずgetter、setterを手書きした普通のクラスでデバッグに慣れるのもよいです。

ケース14：リモートデバッグで接続先が違う

ローカルのSpring Bootではなく、Tomcat、Docker、別サーバー、リモートJVMに接続してデバッグしている場合があります。

このときは、Eclipseで開いているコードと、接続先で動いているコードが一致していないとブレークポイントが効きません。

リモートデバッグでは、「Eclipseで見ているもの」と「サーバーで動いているもの」が別物になりやすいです。

同じ教科書を見ているつもりでも、相手は旧版の教科書を読んでいるような状態です。

ケース15：Eclipseのワークスペースやプロジェクト設定が壊れている

頻度は高くありませんが、Eclipseのワークスペース設定やプロジェクト設定が不安定になっていることもあります。

たとえば、次のようなケースです。

この場合は、次の順番で試します。

Project
Clean

Maven
Update Project

Eclipseを再起動

プロジェクトを再インポート

いきなりワークスペースを作り直す必要はありません。

まずは軽い対処から試しましょう。

新人エンジニア向けの確認手順

ブレークポイントが置けない、または効かないときは、次の順番で確認してください。

この順番で見ると、かなりの問題は解決できます。

Spring BootのControllerで確認する例

たとえば、次のControllerにブレークポイントを置きたいとします。

@Controller
public class CarController {

    @GetMapping("/cars")
    public String list(Model model) {

        System.out.println("listメソッドに入りました");

        List<CarDto> carList = carsDao.findAll();

        model.addAttribute("carList", carList);

        return "cars/list";
    }
}

ブレークポイントを置くなら、次の行がよいです。

System.out.println("listメソッドに入りました");

または、次の行です。

List<CarDto> carList = carsDao.findAll();

もし止まらないなら、次を確認します。

置けないのか、置けるが止まらないのかを分ける

ブレークポイントのトラブルでは、「置けない」と「止まらない」を分けることが大切です。

この区別をしないと、調査が遠回りになります。

病院で「痛いです」だけでなく、「どこが、いつ、どのように痛いか」を伝える必要があるのと同じです。

ブレークポイントが効かないときにやってはいけないこと

焦って次のようなことをすると、余計に原因がわからなくなります。

ブレークポイントが効かないときほど、落ち着いて1つずつ確認しましょう。

デバッグの問題も、デバッグする必要があります！

おすすめの復旧手順

どうしても原因がわからないときは、次の手順で復旧を試してください。

1. Spring Bootアプリを完全に停止する
2. BreakpointsビューでSkip All Breakpointsを確認する
3. Project > Clean を実行する
4. Maven > Update Project を実行する
5. Eclipseを再起動する
6. 対象Controllerの先頭にSystem.out.printlnを入れる
7. Debug As > Spring Boot Appで起動する
8. 正しいURLへアクセスする

この手順は、地味ですがかなり有効です。

特に、古いclassや古い起動プロセスが原因の場合、停止とCleanと再Debug起動で直ることが多いです。

まとめ

Eclipse上のJavaコードでブレークポイントを置けるはずが置けない、または置いても止まらない場合、原因は1つではありません。

主に、Eclipseのブレークポイント設定、起動方法、実行されるコード、ソースとclassの対応、コンパイル時のデバッグ情報を確認します。

一言でまとめるなら、ブレークポイントは「Eclipseに丸を付ける機能」ではなく、「実行中のJVMとソースコードの行を対応させて止める仕組み」です。

そのため、Debug起動、実行行、ソースとclassの一致、ブレークポイントの有効状態がそろって初めて正しく動きます。

新人エンジニアは、まず「Debugで起動しているか」「そのメソッドに本当に入っているか」「Skip All Breakpointsがオンになっていないか」の3つを確認してください。

今後の学習では、EclipseのDebugパースペクティブ、Breakpointsビュー、Variablesビュー、Consoleビュー、Project Clean、Maven Update、Spring Bootの起動構成を順番に学ぶとよいです。ブレークポイントが効かないときも、慌てずに原因を切り分ける力を身につけましょう！

セイ・コンサルティング・グループでは新人エンジニア研修のアシスタント講師を募集しています。

投稿者プロフィール

山崎講師代表取締役

セイ・コンサルティング・グループ株式会社代表取締役。
岐阜県出身。
2000年創業、2004年会社設立。
IT企業向け人材育成研修歴業界歴20年以上。
すべての無駄を省いた費用対効果の高い「筋肉質」な研修を提供します！
この記事に間違い等ありましたらぜひお知らせください。

学生時代は趣味と実益を兼ねてリゾートバイトにいそしむ。長野県白馬村に始まり、志賀高原でのスキーインストラクター、沖縄石垣島、北海道トマム。高じてオーストラリアのゴールドコーストでツアーガイドなど。現在は野菜作りにはまっている。

最新の投稿

• 新人エンジニア研修講師2026年6月16日Eclipse上のJavaコードでブレークポイントを置けなくなるケースとは？Spring Boot開発の新人エンジニア向けに解説
• 新人エンジニア研修講師2026年6月16日Thymeleafのth:valueで送ることができる情報・できない情報を新人エンジニア向けに解説
• 新人エンジニア研修講師2026年6月16日生成AIはパターン認識しているだけなのか？肯定側と否定側から新人エンジニア向けに議論する
• 新人エンジニア研修講師2026年6月16日ログイン機能があるシステムでは開発時にも毎回ログインするのか？新人エンジニア向けに実務の考え方を解説