https://nwma-fywf.pages.dev/tags/hmcl-%E5%90%AF%E5%8A%A8%E5%99%A8/Recent content in HMCL 启动器 on NWMA_FYWFHugozh-cnSun, 15 Feb 2026 16:25:00 +0800https://nwma-fywf.pages.dev/posts/fedora-43-%E4%B8%8B-hmcl-%E7%9A%84%E5%AE%89%E8%A3%85%E6%8C%87%E5%8D%97/Sun, 15 Feb 2026 16:25:00 +0800https://nwma-fywf.pages.dev/posts/fedora-43-%E4%B8%8B-hmcl-%E7%9A%84%E5%AE%89%E8%A3%85%E6%8C%87%E5%8D%97/<p>前一段在 Fedora 43 上尝试运行 HMCL 时遇到了一个问题。即明明已经安装了 OpenJDK，却提示缺少 JavaFX 组件。经过一番折腾，终于找到了解决方案，在此记录分享</p> <hr> <h2 id="问题现象"><strong>问题现象</strong></h2> <p>直接 <code>java -jar HMCL-3.7.5.jar</code> 出现如下错误</p> <div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-shell" data-lang="shell"><span style="display:flex;"><span>dev@192:~/.local/opt/hmcl$ java -jar HMCL-3.7.5.jar </span></span><span style="display:flex;"><span><span style="color:#f92672">[</span>09:47:11<span style="color:#f92672">]</span> <span style="color:#f92672">[</span>@.util.SelfDependencyPatcher.patch/INFO<span style="color:#f92672">]</span> Missing JavaFX dependencies, attempting to patch in missing classes </span></span><span style="display:flex;"><span>Exception in thread <span style="color:#e6db74">&#34;main&#34;</span> java.awt.HeadlessException: </span></span><span style="display:flex;"><span>No X11 DISPLAY variable was set, </span></span><span style="display:flex;"><span>or no headful library support was found, </span></span><span style="display:flex;"><span>but this program performed an operation which requires it. </span></span><span style="display:flex;"><span> at java.desktop/java.awt.GraphicsEnvironment.checkHeadless<span style="color:#f92672">(</span>GraphicsEnvironment.java:158<span style="color:#f92672">)</span> </span></span><span style="display:flex;"><span> at java.desktop/java.awt.Window.&lt;init&gt;<span style="color:#f92672">(</span>Window.java:518<span style="color:#f92672">)</span> </span></span><span style="display:flex;"><span> at java.desktop/java.awt.Frame.&lt;init&gt;<span style="color:#f92672">(</span>Frame.java:428<span style="color:#f92672">)</span> </span></span><span style="display:flex;"><span> at java.desktop/java.awt.Frame.&lt;init&gt;<span style="color:#f92672">(</span>Frame.java:393<span style="color:#f92672">)</span> </span></span><span style="display:flex;"><span> at java.desktop/javax.swing.SwingUtilities$SharedOwnerFrame.&lt;init&gt;<span style="color:#f92672">(</span>SwingUtilities.java:1919<span style="color:#f92672">)</span> </span></span><span style="display:flex;"><span> at java.desktop/javax.swing.SwingUtilities.getSharedOwnerFrame<span style="color:#f92672">(</span>SwingUtilities.java:1987<span style="color:#f92672">)</span> </span></span><span style="display:flex;"><span> at java.desktop/javax.swing.JDialog.&lt;init&gt;<span style="color:#f92672">(</span>JDialog.java:276<span style="color:#f92672">)</span> </span></span><span style="display:flex;"><span> at java.desktop/javax.swing.JDialog.&lt;init&gt;<span style="color:#f92672">(</span>JDialog.java:210<span style="color:#f92672">)</span> </span></span><span style="display:flex;"><span> at java.desktop/javax.swing.JDialog.&lt;init&gt;<span style="color:#f92672">(</span>JDialog.java:158<span style="color:#f92672">)</span> </span></span><span style="display:flex;"><span> at org.jackhuang.hmcl.util.SelfDependencyPatcher$ProgressFrame.&lt;init&gt;<span style="color:#f92672">(</span>SelfDependencyPatcher.java:396<span style="color:#f92672">)</span> </span></span><span style="display:flex;"><span> at org.jackhuang.hmcl.util.SelfDependencyPatcher.fetchDependencies<span style="color:#f92672">(</span>SelfDependencyPatcher.java:277<span style="color:#f92672">)</span> </span></span><span style="display:flex;"><span> at org.jackhuang.hmcl.util.SelfDependencyPatcher.patch<span style="color:#f92672">(</span>SelfDependencyPatcher.java:185<span style="color:#f92672">)</span> </span></span><span style="display:flex;"><span> at org.jackhuang.hmcl.EntryPoint.checkJavaFX<span style="color:#f92672">(</span>EntryPoint.java:185<span style="color:#f92672">)</span> </span></span><span style="display:flex;"><span> at org.jackhuang.hmcl.EntryPoint.main<span style="color:#f92672">(</span>EntryPoint.java:55<span style="color:#f92672">)</span> </span></span><span style="display:flex;"><span> at org.jackhuang.hmcl.Main.main<span style="color:#f92672">(</span>Main.java:78<span style="color:#f92672">)</span> </span></span><span style="display:flex;"><span>^Cdev@192:~/.local/opt/hmcl$ </span></span></code></pre></div><p>这个 <code>java.awt.HeadlessException</code> 错误表明 Java 无法找到图形显示环境</p>