JXTable排序操作时后备模型变更偶尔抛出IllegalArgumentException问题

这个问题我之前维护Swing桌面应用时也碰到过，核心原因就是打破了Swing的单线程模型规则——你在非EDT线程直接修改了数据模型的后备Vector，而JXTable的排序逻辑（依赖TableRowSorter）是在EDT线程执行的，两者并发操作导致模型状态不一致，最终抛出异常。

问题根源拆解 #

Swing要求所有与UI相关的操作（包括数据模型的更新，因为模型变化会触发UI重绘、排序逻辑更新）必须在Event Dispatch Thread（EDT）中执行。你在非EDT线程修改Vector并触发模型事件，会引发两个核心问题：

• TableRowSorter在排序时正遍历模型数据，此时Vector被修改（比如移除最旧记录），容易引发并发修改或索引越界
• 模型事件在非EDT触发，导致JXTable的UI状态和实际模型数据不同步，排序时出现数据不匹配

具体解决方案 #

1. 将所有模型更新操作移到EDT执行

用SwingUtilities.invokeLater()或invokeAndWait()把添加/删除记录的逻辑包裹起来，确保所有修改都在EDT中进行。示例代码：

// 非EDT线程中触发更新的逻辑
SwingUtilities.invokeLater(() -> {
    // 同步后备Vector，避免多线程访问冲突
    synchronized (yourBackingVector) {
        // 添加新记录
        yourBackingVector.add(newRecord);
        // 超出限制时移除最旧记录
        if (yourBackingVector.size() > 2500) {
            yourBackingVector.remove(0);
        }
        // 触发精确的模型事件，比fireTableDataChanged更高效
        if (yourBackingVector.size() == 2500) {
            // 刚移除了第一条，触发删除事件
            yourCustomModel.fireTableRowsDeleted(0, 0);
        }
        // 触发新增行的事件
        yourCustomModel.fireTableRowsInserted(yourBackingVector.size() - 1, yourBackingVector.size() - 1);
    }
});

2. 确保模型的所有数据访问方法线程安全

如果自定义模型的getRowCount()、getValueAt()等方法会被EDT线程（比如排序时）调用，要确保这些方法访问Vector时是线程安全的。最简单的方式是在这些方法中同步Vector：

@Override
public int getRowCount() {
    synchronized (yourBackingVector) {
        return yourBackingVector.size();
    }
}

@Override
public Object getValueAt(int rowIndex, int columnIndex) {
    synchronized (yourBackingVector) {
        return yourBackingVector.get(rowIndex).getColumnValue(columnIndex);
    }
}

3. 高频更新时临时禁用排序（可选优化）

如果你的数据更新频率很高，可以在更新模型前暂时禁用JXTable的排序，更新完成后再恢复，避免排序过程中模型变化导致冲突：

SwingUtilities.invokeLater(() -> {
    TableRowSorter<?> sorter = (TableRowSorter<?>) yourJXTable.getRowSorter();
    // 保存当前排序状态
    List<SortKey> sortKeys = sorter.getSortKeys();
    // 禁用排序
    sorter.setSortKeys(null);
    
    // 执行模型更新操作...
    
    // 恢复排序状态
    sorter.setSortKeys(sortKeys);
});

关键提醒 #

永远不要在非EDT线程直接修改Swing组件或其关联的数据模型——哪怕你觉得只是修改一个后备集合。Swing的单线程模型是硬性规则，违反它必然会导致各种难以复现的线程安全问题，比如你遇到的排序异常、UI卡顿甚至崩溃。

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