JDK11+TornadoFX 2.0.0下TableView滚动大量行UI冻结问题排查

可能的原因 #

• JavaFX 11+的TableView滚动逻辑改动：JDK9之后JavaFX成为独立模块，scrollTo方法内部的布局计算、虚拟化行定位逻辑相比JDK8有明显性能开销增加，大数据量下频繁调用会直接阻塞UI线程。
• TornadoFX 2.0.0的适配细节问题：TornadoFX 2.x针对JDK11+重构了部分UI扩展，其封装的scrollTo方法可能引入了额外的监听校验逻辑，放大了原本的性能问题。
• 高频调用导致UI线程过载：每秒20次的scrollTo请求在JDK11下单次执行成本更高，大量任务堆积在UI线程队列，导致渲染和更新无法及时完成。

解决方案 #

1. 合并scrollTo请求，减少UI线程调用 #

不要每次触发都直接调用scrollTo，而是合并短时间内的重复请求，只响应最新的目标位置：

import javafx.application.Platform
import java.util.concurrent.atomic.AtomicInteger

// 用原子变量保存最新目标行，避免多线程冲突
private val targetRow = AtomicInteger(-1)

// 外部更新目标行的方法
fun updateScrollTarget(row: Int) {
    targetRow.set(row)
}

// 初始化定时任务，批量处理滚动请求
init {
    Thread {
        while (true) {
            Thread.sleep(50)
            val currentTarget = targetRow.getAndSet(-1)
            if (currentTarget != -1) {
                Platform.runLater {
                    tableView.scrollTo(currentTarget)
                }
            }
        }
    }.start()
}

这样即便短时间内多次更新目标行，也只会执行一次滚动操作，大幅降低UI线程压力。

2. 固定行高+优化虚拟化配置 #

给TableView设置固定行高，让JavaFX跳过动态行高计算，提升虚拟化效率；同时固定列宽，避免滚动时触发列重计算：

// 设置固定行高（根据你的实际行高调整）
tableView.fixedCellSize = 24.0
// 启用固定列宽策略
tableView.columnResizePolicy = TableView.CONSTRAINED_RESIZE_POLICY

JDK11+的TableView虚拟化对固定行高的依赖更强，显式配置后能显著减少滚动时的布局开销。

3. 直接调用JavaFX原生scrollTo方法 #

跳过TornadoFX的扩展封装，使用JavaFX原生的scrollTo方法，减少额外逻辑的性能损耗：

// 替换TornadoFX的scrollTo调用
tableView.scrollTo(targetIndex)
// 若需要将目标行滚动到顶部，可指定位置：
tableView.scrollTo(targetIndex, TableView.ScrollToPosition.TOP)

4. 实现数据懒加载 #

400万行数据完全加载到内存会极大消耗资源，改用懒加载列表，仅加载当前可见区域及前后少量数据：

class LazyDataList(
    private val totalRows: Int,
    private val loadChunk: (start: Int, end: Int) -> List<YourDataModel>
) : ObservableListBase<YourDataModel>() {
    private val dataCache = mutableMapOf<Int, YourDataModel>()
    private var currentVisibleRange = IntRange(0, 0)

    override fun get(index: Int): YourDataModel {
        return dataCache.getOrPut(index) {
            // 按块加载数据（这里按100行一块，可调整）
            val chunkStart = (index / 100) * 100
            val chunkEnd = min(chunkStart + 100, totalRows)
            val chunkData = loadChunk(chunkStart, chunkEnd)
            chunkData.forEachIndexed { i, data -> dataCache[chunkStart + i] = data }
            chunkData[index - chunkStart]
        }
    }

    override fun size(): Int = totalRows

    // 绑定到TableView，监听滚动预加载附近数据
    fun bindToTableView(tableView: TableView<YourDataModel>) {
        tableView.scrollPane.vvalueProperty().addListener { _, _, _ ->
            val firstVisible = tableView.firstVisibleRow
            val lastVisible = tableView.lastVisibleRow
            // 预加载可见区域前后200行数据
            val newRange = IntRange(
                max(0, firstVisible - 200),
                min(totalRows - 1, lastVisible + 200)
            )
            if (newRange != currentVisibleRange) {
                currentVisibleRange = newRange
                // 触发预加载
                (newRange.start..newRange.endInclusive).forEach { get(it) }
            }
        }
    }
}

使用时将TableView的items替换为这个懒加载列表，滚动时仅处理少量可见数据，性能会大幅提升。

5. 升级TornadoFX版本 #

尝试升级到TornadoFX最新稳定版（如2.0.20及以上），新版本可能修复了JDK11下TableView滚动的性能兼容问题。

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