Home About Me

The Case of the Missing libawt_xawt.so in OpenJDK 17

A jar failed to start on my Linux laptop with this error:

Exception in thread "main" java.lang.UnsatisfiedLinkError: Can't load library: /usr/lib/jvm/java-17-openjdk-amd64/lib/libawt_xawt.so
    at java.base/java.lang.ClassLoader.loadLibrary(ClassLoader.java:2393)
    at java.base/java.lang.Runtime.load0(Runtime.java:755)
    at java.base/java.lang.System.load(System.java:1953)
    at java.base/jdk.internal.loader.NativeLibraries.load(Native Method)
    at java.base/jdk.internal.loader.NativeLibraries$NativeLibraryImpl.open(NativeLibraries.java:388)
    at java.base/jdk.internal.loader.NativeLibraries.loadLibrary(NativeLibraries.java:232)
    at java.base/jdk.internal.loader.NativeLibraries.loadLibrary(NativeLibraries.java:174)
    at java.base/jdk.internal.loader.NativeLibraries.findFromPaths(NativeLibraries.java:315)
    at java.base/jdk.internal.loader.NativeLibraries.loadLibrary(NativeLibraries.java:285)
    at java.base/java.lang.ClassLoader.loadLibrary(ClassLoader.java:2398)
    at java.base/java.lang.Runtime.loadLibrary0(Runtime.java:818)
    at java.base/java.lang.System.loadLibrary(System.java:1989)
    at java.desktop/java.awt.Toolkit$2.run(Toolkit.java:1388)
    at java.desktop/java.awt.Toolkit$2.run(Toolkit.java:1386)
    at java.base/java.security.AccessController.doPrivileged(AccessController.java:318)
    at java.desktop/java.awt.Toolkit.loadLibraries(Toolkit.java:1385)
    at java.desktop/java.awt.Toolkit.initStatic(Toolkit.java:1423)
    at java.desktop/java.awt.Toolkit.<clinit>(Toolkit.java:1397)
    at java.desktop/javax.swing.UIManager.getSystemLookAndFeelClassName(UIManager.java:668)
    at us.deathmarine.luyten.Luyten.main(Luyten.java:47)

The library path pointed to OpenJDK 17's lib directory, but checking the file showed it wasn't there:

➜  tmp ll /usr/lib/jvm/java-17-openjdk-amd64/lib/libawt_xawt.so
ls: cannot access '/usr/lib/jvm/java-17-openjdk-amd64/lib/libawt_xawt.so': No such file or directory

I reinstalled openjdk17:

apt install openjdk-17-jdk

This time the file was present:

➜  tmp ll /usr/lib/jvm/java-17-openjdk-amd64/lib/libawt_xawt.so
-rw-r--r-- 1 root root 464K Jun 12 02:08 /usr/lib/jvm/java-17-openjdk-amd64/lib/libawt_xawt.so

The jar also ran normally.

Why was the JDK incomplete?

Why would the Linux-provided JDK be missing some packages and need a manual install? The installation log shows that the previous setup was missing openjdk-17-jdk, openjdk-17-jdk-headless, and openjdk-17-jre — in fact, all of them were absent. I couldn't figure out why.

➜  tmp apt install openjdk-17-jdk
Reading package lists... Done
Building dependency tree... Done
Reading state information... Done
The following packages were automatically installed and are no longer required:
  glx-alternative-mesa update-glx
Use 'sudo apt autoremove' to remove them.
The following additional packages will be installed:
  openjdk-17-jdk-headless openjdk-17-jre
Suggested packages:
  openjdk-17-demo openjdk-17-source visualvm
The following NEW packages will be installed:
  openjdk-17-jdk openjdk-17-jdk-headless openjdk-17-jre
0 upgraded, 3 newly installed, 0 to remove and 7 not upgraded.
Need to get 71.4 MB of archives.
After this operation, 79.0 MB of additional disk space will be used.
Do you want to continue? [Y/n] y