Java - NoSuchMethodErrorの原因と解決策

NoSuchMethodError は、呼び出すメソッドがクラスに定義されていない場合に発生します。通常、コンパイル中にすべて検出されるために発生しませんが、使用する外部ライブラリの互換性の問題でRuntimeにエラーが発生する可能性があります。

Exception in thread "main" java.lang.NoSuchMethodError: 'void NoSuchMethodErrorExample.print(java.lang.String)'
    at Main.main(Main.java:4)

1. 問題が発生する理由

次のように、Userクラスが別のJARファイルにコンパイルされているとしましょう。

public static class User implements Serializable {
    private String name;

    public User(String name) {
        this.name = name;
    }

    public String getName() {
        return "User{name=" + name +  "}";
    }
}

そして私のプロジェクトでこのJARをimportして使っていて、以下のように getName()でUserの名前を出力しています。

public class Example {

    public static void main(String[] args) throws IOException, ClassNotFoundException {
        User user = new User("John");
        System.out.println(user);
    }
}

上記のコードは、 Example_Main.jar、 User_Library.jarファイルでそれぞれビルドして実行するようにしました。

外部モジュールコードの変更

この時、下記のようにUserクラスからgetName()を削除してリビルドしたと考えてみてください。このコードをコンパイルし、 User_Library_v2.jarという名前で保存しました。

public static class User implements Serializable {
    private String name;

    public User(String name) {
        this.name = name;
    }
}

互換性の問題が発生しました

もし Example_Main.jar、User_Library_v2.jar ファイルでプログラムを実行すると、 Example_Main.jar は User クラスの getName() メソッドを呼び出すようになり、このメソッドは User_Library_v2.jar で定義されないため、NoSuchMethodErrorが発生します。

2. 回避策

問題を解決する方法は、依存モジュールのコードを一緒に構築することです。互換性の問題が発生すると、コンパイルエラーが発生するため、問題コードを簡単に見つけて修正できます。

プロジェクトのサブモジュールでコンパイルされておらず、外部ライブラリを使用するときに問題が発生した場合は、どのクラスで問題が発生したのかを探して、このクラスを使用するライブラリをすべて見つけてください。そして、すべて互換性のあるバージョンを使用していることを確認し、問題のあるライブラリを互換性の問題がないものと交換してください。

References

• Oracle - NoSuchMethodError