I’m packaging a Java library as a JAR, and it’s throwing many java.lang.IncompatibleClassChangeError
s when I try to invoke methods from it. These errors seem to appear at random. What kinds of problems could be causing this error?
Advertisement
Answer
This means that you have made some incompatible binary changes to the library without recompiling the client code. Java Language Specification ยง13 details all such changes, most prominently, changing non-static
non-private fields/methods to be static
or vice versa.
Recompile the client code against the new library, and you should be good to go.
UPDATE: If you publish a public library, you should avoid making incompatible binary changes as much as possible to preserve what’s known as “binary backward compatibility”. Updating dependency jars alone ideally shouldn’t break the application or the build. If you do have to break binary backward compatibility, it’s recommended to increase the major version number (e.g. from 1.x.y to 2.0.0) before releasing the change.