如何检测JLabel中合法HTML是否成功渲染并完整显示所有Glyph？

要确认你的HTML字符串在JLabel里是否正确渲染、所有预期Glyph都显示完整，你可以从以下几个实用方向入手：

1. 直观视觉验证+自动化截图比对 #

最直接的方式就是运行程序后肉眼核对JLabel的显示效果：确认<h3>的标题样式正常，三个列表项的<b>S</b>是粗体，后续文本完整显示，没有截断或方块（缺失Glyph的典型表现）。

如果需要自动化验证，可以用Swing的Robot类捕获JLabel的屏幕区域，和预先保存的基准正确渲染截图做像素比对。注意要控制环境变量（比如系统字体、DPI、窗口缩放比例）一致，避免误判。示例代码片段：

JLabel label = new JLabel("<html><h3>Title</h3><ul><li><b>S</b>tuff</li><li><b>S</b>taff</li><li><b>S</b>tiff</li></ul></html>");
// 确保组件已显示在屏幕上
SwingUtilities.invokeLater(() -> {
    try {
        Robot robot = new Robot();
        Rectangle bounds = label.getBounds();
        // 转换为屏幕坐标
        bounds.setLocation(label.getLocationOnScreen());
        BufferedImage screenshot = robot.createScreenCapture(bounds);
        // 这里可以和基准图做像素比对，比如用ImageIO读取基准图后逐像素对比
    } catch (AWTException e) {
        e.printStackTrace();
    }
});

2. 检查Swing的HTML View树结构 #

Swing渲染HTML依赖HTMLEditorKit的View体系，每个HTML元素都会对应一个View节点。你可以获取JLabel的View树，遍历检查是否存在所有预期的节点：

• 有没有对应<h3>的HeadingView
• 有没有三个对应<li>的ListView
• 每个列表项里有没有对应<b>的BoldView和后续文本的LabelView

示例代码：

View rootView = label.getUI().getView(label);
// 递归遍历View树的方法
private void traverseView(View view) {
    System.out.println("View类型: " + view.getClass().getSimpleName());
    // 检查View的内容，比如文本内容
    if (view instanceof LabelView) {
        LabelView labelView = (LabelView) view;
        System.out.println("文本内容: " + labelView.getText(0, labelView.getLength()));
    }
    for (int i = 0; i < view.getViewCount(); i++) {
        traverseView(view.getView(i));
    }
}
// 调用遍历
traverseView(rootView);

如果遍历结果里缺少某个预期的View类型，就说明HTML解析或渲染出了问题。

3. 验证Glyph的存在与布局 #

对于文本的Glyph（字形），可以通过FontMetrics或TextLayout检查每个字符是否能被正确渲染：

• 获取每个文本节点的AttributedString
• 用FontRenderContext生成TextLayout
• 检查每个字符对应的GlyphIndex是否有效，没有出现缺失（缺失Glyph通常会返回默认的占位符索引）

示例片段：

if (view instanceof LabelView) {
    LabelView labelView = (LabelView) view;
    AttributedString attrStr = labelView.getAttributedString();
    FontRenderContext frc = labelView.getFontRenderContext();
    TextLayout layout = new TextLayout(attrStr.getIterator(), frc);
    GlyphVector glyphVector = layout.getGlyphVector();
    for (int i = 0; i < glyphVector.getNumGlyphs(); i++) {
        // 检查Glyph是否有效，比如是否是占位符
        if (glyphVector.getGlyphCharIndex(i) == -1) {
            System.out.println("缺失Glyph，索引: " + i);
        }
    }
}

4. 确保在渲染完成后再检测 #

Swing的渲染是异步的，如果你在组件刚创建就检测，可能还没完成渲染。可以用SwingUtilities.invokeLater延迟检测，或者给JLabel添加HierarchyListener，监听组件显示到屏幕的事件：

label.addHierarchyListener(e -> {
    if ((e.getChangeFlags() & HierarchyEvent.SHOWING_CHANGED) != 0 && label.isShowing()) {
        // 此时组件已显示，执行检测逻辑
        traverseView(label.getUI().getView(label));
    }
});

另外，针对你遇到的异常情况，也可以先排查这些常见问题：

• JLabel的尺寸是否足够？有没有被布局管理器限制导致内容截断？可以尝试设置label.setPreferredSize(new Dimension(200, 150))测试
• 系统是否缺失对应字体的粗体样式？比如你的默认字体没有粗体，导致<b>S</b>无法正常显示
• HTML字符串是否有隐性的语法问题？比如有没有未闭合的标签（你的例子里看起来是正常的，但可以用HTML校验工具确认）

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