Qt中QList::operator[]索引越界断言失败问题求助

核心问题 #

你遇到的ASSERT failure in QList::operator[]: "index out of range"，直接指向**commandColumn[index.row()]的索引访问超出了QList的有效范围**——也就是index.row()的值大于等于commandColumn的元素总数了。

Debug模式下Qt会触发这个断言提醒你，Release模式下这种操作可能直接导致程序崩溃或者返回不可预料的垃圾值。

常见触发场景 #

1. Model行数与数据源不匹配
   自定义TableModel的rowCount()方法返回的行数，比commandColumn实际的元素数量多。比如rowCount()返回10，但commandColumn只有5个元素，当视图请求第5行及以后的数据时，就会触发越界。
2. 数据源被意外修改
   可能在某个逻辑里清空了commandColumn（比如调用clear()），但没有重新填充元素，或者添加元素的逻辑有遗漏，导致数据源长度不足。
3. 索引计算错误
   比如index.row()的取值逻辑有问题，返回了负数或者超出预期的数值。

排查与修复步骤 #

• 检查rowCount()实现
  确保rowCount()直接返回commandColumn的长度，示例代码：

  int MyTableModel::rowCount(const QModelIndex &parent) const
  {
      Q_UNUSED(parent);
      return commandColumn.size(); // 不要返回固定值或其他不匹配的数量
  }
  

• 添加边界检查
  在访问commandColumn[index.row()]前先做判断，避免越界：

  // 比如在data()方法中
  if (index.isValid() && index.row() >= 0 && index.row() < commandColumn.size()) {
      return commandColumn[index.row()];
  } else {
      return QVariant(); // 返回空值或默认值
  }
  

• 排查数据源的修改逻辑
  检查所有操作commandColumn的代码，确认元素添加、删除、清空的逻辑是否正确，有没有遗漏填充数据的情况。

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