JavaFX TreeView展开/折叠箭头Bug：求解决方案或代码排查

嘿，这个TreeView箭头乱跳的bug我之前在Windows平台用早期JDK10的时候也碰到过，确实挺闹心的！结合你的情况，我整理了几个排查方向和解决办法：

先排查是不是自己代码的问题 #

先排除自身代码的可能性，毕竟这种“无规律”的bug有时候也可能是我们自己的操作导致的：

• 检查自定义CSS：如果你给TreeView加了自定义样式，看看是不是CSS选择器写得太宽泛（比如没限定特定TreeView的id或样式类），导致箭头样式串到了其他节点；或者修改-fx-shape时写错了路径，引发渲染异常。
• 确认线程安全：有没有在非FX Application Thread里操作TreeView的节点？比如后台线程里修改节点的expanded属性，这会导致UI状态不一致，出现随机错乱。所有JavaFX组件的操作必须在主线程执行。
• 避免频繁刷新：如果你的代码频繁添加/删除节点、重复设置展开状态，也可能触发渲染层的bug，尽量优化成批量更新或者减少不必要的状态切换。

关于OpenJDK记录的这个bug #

你提到的问题确实是JavaFX在早期JDK10（尤其是Windows 64位版本）里存在的渲染bug，和Prism渲染引擎的硬件加速逻辑有关，属于平台特定的底层问题，不是你的代码错了。

修复/规避方案 #

1. 优先升级JDK版本 #

JDK10是短期支持版本，生命周期很短，后续的JDK11（LTS）以及更高版本已经修复了大量JavaFX的UI渲染问题。升级到JDK11+是最彻底的解决办法，而且LTS版本也更稳定，适合生产环境。

2. 禁用硬件加速（临时救急） #

如果暂时没法升级JDK，可以尝试禁用JavaFX的硬件加速，强制用软件渲染。启动你的应用时添加VM参数：

-Dprism.order=sw

亲测这个方法能有效规避Windows平台下的箭头渲染错乱问题，缺点是可能会稍微降低UI渲染性能，但对于普通应用来说影响不大。

3. 自定义箭头图标绕过原生bug #

如果上面的方法都不适用，可以用CSS完全替换默认的箭头样式，用自定义图标替代：

/* 替换折叠状态的箭头 */
.tree-cell .tree-disclosure-node .arrow {
    -fx-shape: ""; /* 清空默认形状 */
    -fx-background-image: url("icons/collapsed-arrow.png");
    -fx-background-size: 14px 14px;
    -fx-background-repeat: no-repeat;
    -fx-background-position: center;
    -fx-background-color: transparent;
}

/* 替换展开状态的箭头 */
.tree-cell:expanded .tree-disclosure-node .arrow {
    -fx-background-image: url("icons/expanded-arrow.png");
}

这样完全脱离原生箭头的渲染逻辑，自然不会碰到那个bug。你可以用SVG或者PNG图标，根据自己的UI风格调整。

4. 手动触发UI刷新 #

如果偶尔出现箭头错乱，可以在节点展开/折叠的事件监听里手动调用刷新：

treeView.getSelectionModel().selectedItemProperty().addListener((obs, oldVal, newVal) -> {
    if (newVal != null) {
        treeView.refresh();
    }
});

不过这个方法只是临时救急，频繁刷新可能会有性能问题，不建议作为长期方案。

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