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