构建JAR后Java应用TableView选中行与编辑单元格错位问题

问题概述 #

为JavaFX TableView实现了按下Enter自动换行并切换至下一行编辑状态的功能，调试阶段运行正常，但打包为JAR后用JRE 8u411运行时，当TableView包含大量需要滚动的行，出现选中行与编辑单元格错位的问题。

可能的原因 #

• JavaFX与JRE版本不兼容：你使用的JavaFX 14基于JDK 11及以上版本开发，而运行JAR的JRE 8属于旧版本分支，两者的TableView虚拟滚动逻辑、事件处理机制存在差异，大量行滚动时容易出现视图与数据模型的索引映射错误。
• 事件处理时序问题：调试时用JDK 22运行，UI更新和事件触发的时序与JRE 8环境不同，直接在onKeyTyped事件中同步执行focus和edit操作，可能在虚拟滚动的视图更新未完成时就修改了聚焦状态，导致错位。
• 索引操作逻辑瑕疵：当前代码中，聚焦的是focusedCell.getRow() + 1行，但编辑的是原focusedCell.getRow()行，逻辑本身存在矛盾；同时未考虑虚拟滚动下视图行与数据模型行的同步延迟。

解决方案 #

1. 统一运行环境版本 #

• 改用与JavaFX 14兼容的JDK（如JDK 14/17/22）运行JAR文件，避免跨大版本的JavaFX与JRE混用；
• 若必须使用JRE 8，将JavaFX版本降级为JavaFX 8，确保运行环境依赖版本一致。

2. 修正事件处理逻辑 #

调整代码逻辑，确保聚焦和编辑的是同一行，且延迟执行UI操作以等待视图更新完成：

tableData.setOnKeyTyped(event -> {
    if (!"Enter".equals(event.getCharacter())) {
        return;
    }
    TablePosition<List<StringProperty>, String> focusedCell = tableData.getFocusModel().getFocusedCell();
    if (focusedCell == null) {
        return;
    }
    int currentRow = focusedCell.getRow();
    // 检查是否为最后一行，避免越界
    if (currentRow >= list.size() - 1) {
        return;
    }
    // 使用Platform.runLater确保UI完成滚动、渲染后再执行操作
    Platform.runLater(() -> {
        tableData.getSelectionModel().select(currentRow + 1);
        tableData.getFocusModel().focus(currentRow + 1, columnDiem);
        tableData.edit(currentRow + 1, columnDiem);
    });
});

同时移除原代码中独立的rowSelect相关逻辑，避免重复操作导致状态冲突。

3. 验证虚拟滚动下的索引一致性 #

确保所有行索引操作基于数据模型的索引，而非视图临时索引。TableView的TablePosition.getRow()返回的是模型中的索引，但虚拟滚动视图更新期间可能存在延迟，Platform.runLater能有效规避这个问题，让UI先完成滚动和行渲染，再执行聚焦编辑操作。

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