无UI图像处理应用中JLabel渲染HTML偶发字体过小如何解决

• 强制所有Swing组件操作在EDT线程同步执行：Swing的单线程模型要求所有组件属性修改、布局计算、渲染操作必须在事件调度线程（EDT）执行，非EDT线程直接操作JLabel的setFont、setSize方法会出现内部属性更新未完成就触发paint的竞态条件，这是偶发字号异常的核心原因。可以用SwingUtilities.invokeAndWait()将所有JLabel相关操作包装，同步等待EDT执行完成后再继续后续逻辑。
• 手动触发布局计算：调用setSize()之后主动执行doLayout()，强制JLabel完成所有内部布局、文本排版计算，避免依赖异步布局事件导致的排版参数未生效问题。
• 修正代码中的变量引用错误：你给出的代码里g.setStroke(new BasicStroke(newFont.getSize() / 10));引用了未在参数中传入的newFont变量，如果该变量是全局可变的，存在并发读写风险，也会导致渲染参数异常，建议替换为传入的参数f。
• 确保Headless模式正确初始化：无UI环境下启动应用时需要添加JVM参数-Djava.awt.headless=true，避免Swing组件初始化时依赖系统图形组件导致的属性计算错误。

private void renderHtmlText(String text, Graphics2D g, Font f) throws Exception {
    // 所有JLabel操作同步到EDT执行，等待执行完成再返回
    SwingUtilities.invokeAndWait(() -> {
        JLabel label = new JLabel(text);
        label.setFont(f);
        
        if(isWrapText()) {
            label.setMaximumSize(new Dimension(wrapWidth, 1000));
        }
        Dimension prefSize = label.getPreferredSize();
        label.setSize(prefSize);
        // 强制完成布局计算
        label.doLayout();
        // 修正变量引用错误，用传入的f而不是全局的newFont
        g.setStroke(new BasicStroke(f.getSize() / 10));
        label.paint(g);
    });
}

内容的提问来源于stack exchange，提问作者jabal