【Java】「シンボルを見つけられません」エラーの原因7つと解決方法

error: cannot find symbol
  symbol:   variable myVariable
  location: class Main

エラーメッセージの読み方

• symbol：見つからなかったシンボルの種類と名前（variable, method, class など）
• location：そのシンボルが探された場所（クラス名やパッケージ名）

public class Main {
    public static void main(String[] args) {
        String message = "Hello";
        System.out.println(mesage);  // NG: "mesage" は未定義
    }
}

修正方法

変数名を正しく "message" に修正する
System.out.println(message);  // OK

注意：Javaでは myVariable と MyVariable と myvariable はすべて別のシンボルとして扱われます。命名規則に従って一貫した名前を使いましょう。

public class Main {
    public static void main(String[] args) {
        // int count = 10; を書き忘れ
        System.out.println(count);  // NG: count が未宣言
    }
}

public class Main {
    public static void main(String[] args) {
        int count = 10;  // 変数を宣言
        System.out.println(count);  // OK: 10 が出力される
    }
}

実行結果

10

// import java.util.ArrayList; が不足！

public class Main {
    public static void main(String[] args) {
        ArrayList<String> list = new ArrayList<>();  // NG
    }
}

import java.util.ArrayList;  // import文を追加

public class Main {
    public static void main(String[] args) {
        ArrayList<String> list = new ArrayList<>();  // OK
        list.add("Hello");
        System.out.println(list);  // [Hello]
    }
}

ポイント：java.lang パッケージのクラス（String、Integer、System など）はimport不要です。それ以外のパッケージのクラスには必ずimport文が必要です。

public class Main {
    public static void main(String[] args) {
        if (true) {
            String result = "成功";
        }
        System.out.println(result);  // NG: result はifブロックの外
    }
}

public class Main {
    public static void main(String[] args) {
        String result = "";  // ブロックの外で宣言
        if (true) {
            result = "成功";  // ブロック内で代入
        }
        System.out.println(result);  // OK: "成功" が出力される
    }
}

// NG: i はforブロック内のみ有効
for (int i = 0; i < 5; i++) {
    System.out.println(i);
}
System.out.println(i);  // NG: cannot find symbol

// OK: ループの外で宣言
int i;
for (i = 0; i < 5; i++) {
    System.out.println(i);
}
System.out.println(i);  // OK: 5 が出力される

import com.google.gson.Gson;  // Gsonライブラリが必要

public class Main {
    public static void main(String[] args) {
        Gson gson = new Gson();  // NG: Gsonがクラスパスにない
    }
}

<dependency>
    <groupId>com.google.code.gson</groupId>
    <artifactId>gson</artifactId>
    <version>2.10.1</version>
</dependency>

dependencies {
    implementation 'com.google.code.gson:gson:2.10.1'
}

ビルドパスの問題が発生するケース

• JARファイルがクラスパスに含まれていない：手動でJARを追加するプロジェクトで発生
• ソースファイルのディレクトリ構成が不正：パッケージ宣言とディレクトリが一致しない
• コンパイル済みクラスが古い：ビルドキャッシュが残っている
• JDKバージョンの不一致：新しいAPIを古いJDKでコンパイルしている

// ファイル: src/main/java/com/example/MyClass.java
package com.example;  // パッケージ名とディレクトリが一致すること

// NG: src/MyClass.java に置いて package com.example; と宣言
// OK: src/main/java/com/example/MyClass.java に配置

# Maven
mvn clean compile

# Gradle
gradle clean build

# 手動コンパイル
javac -d out src/com/example/*.java

public class Calculator {
    public int add(int a, int b) {
        return a + b;
    }
}

public class Main {
    public static void main(String[] args) {
        // NG: add() はインスタンスメソッドなのにクラス名で呼んでいる
        int result = Calculator.add(3, 5);
    }
}

Calculator calc = new Calculator();
int result = calc.add(3, 5);  // OK: インスタンス経由

public class Calculator {
    public static int add(int a, int b) {  // static を追加
        return a + b;
    }
}

// これでクラス名から直接呼び出せる
int result = Calculator.add(3, 5);  // OK

Eclipseでの対処手順

• import文の自動追加：Ctrl + Shift + O（Organize Imports）でimport文を自動整理
• クイックフィックス：エラー箇所にカーソルを合わせて Ctrl + 1 で修正候補を表示
• プロジェクトのクリーン：メニューの [Project] → [Clean…] でビルドキャッシュをクリア
• ビルドパスの確認：プロジェクト右クリック → [Properties] → [Java Build Path] で依存関係を確認
• JDKの確認：[Window] → [Preferences] → [Java] → [Installed JREs] でJDKバージョンを確認

IntelliJ IDEAでの対処手順

• import文の自動追加：Alt + Enter でimport候補を表示し選択
• 自動インポート設定：[Settings] → [Editor] → [General] → [Auto Import] で自動インポートを有効化
• キャッシュの無効化：[File] → [Invalidate Caches / Restart] でキャッシュをクリア
• Maven/Gradleの再読み込み：pom.xml/build.gradle を右クリック → [Reload Project]
• プロジェクト構造の確認：Ctrl + Alt + Shift + S でモジュール・ライブラリの設定を確認

VS Codeでの対処手順

• import文の自動追加：エラー箇所で Ctrl + . を押してクイックフィックスを実行
• Java Language Serverのリセット：コマンドパレット（Ctrl + Shift + P）→ “Java: Clean Java Language Server Workspace”
• ワークスペースのクリーン：コマンドパレット → “Java: Force Java Compilation” → “Full”
• JDK設定の確認：settings.json の java.jdt.ls.java.home を確認

# 依存関係を強制再ダウンロード
mvn clean install -U

# SNAPSHOTの更新を強制
mvn clean compile -U

注意：Maven/Gradleの scope 設定にも注意してください。<scope>test</scope> で追加した依存関係は、テストコード以外では使えません。本番コードで使う場合は compile（Maven）または implementation（Gradle）を指定してください。

Main.java:10: error: cannot find symbol
        System.out.println(mesage);
                           ^
  symbol:   variable mesage      ← 見つからないシンボル名
  location: class Main           ← どのクラスで探したか

ポイント：symbol の行で「何が」見つからないか、location の行で「どこで」探したかがわかります。この2つの情報を元に原因を特定しましょう。

デバッグチェックリスト

• シンボル名の綴りに間違いはないか？（大文字小文字を含む）
• 変数は使用前に宣言されているか？
• 変数のスコープ内からアクセスしているか？
• 必要なimport文があるか？
• クラス名・メソッド名は正しいか？（Java APIドキュメントで確認）
• 外部ライブラリの依存関係は設定されているか？
• ビルドパス/クラスパスは正しいか？
• IDEのキャッシュが古くなっていないか？

# クラスパスを明示的に指定してコンパイル
javac -cp "lib/*:." Main.java

# 詳細なエラー情報を表示（-Xlint オプション）
javac -Xlint:all Main.java

# ソースパスを明示的に指定
javac -sourcepath src -d out src/com/example/Main.java

注意：以下の「よくある罠」にも気をつけましょう。