Apache Doris：Tablet写入失败求助（附具体错误参数）

err=-235 对应 Doris 的 ERR_TABLET_VERSION_TOO_MANY 错误，说明目标 tablet 的版本数量超过阈值，导致写入无法执行，这通常和 compaction 异常直接相关，可按以下步骤排查：

• 检查目标 tablet 版本状态
  执行 FE 查询语句查看该 tablet 的详细版本信息：

  SHOW TABLET 27306172;
  

  重点关注 version_count 字段，若数值接近或超过默认阈值 max_tablet_version_num（默认1000），说明版本堆积问题严重。

• 核查 compaction 任务状态

  • 查看指定表的 compaction 统计：

    SHOW COMPACTION FROM your_database.your_table;
    

  • 查看 BE 节点的 be.INFO 日志，搜索该 tablet_id 或 compaction 关键词，排查是否存在以下异常：
    • 内存不足导致 compaction 任务终止
    • compaction 任务长时间排队未执行
    • compaction 执行过程中出现报错

• 紧急恢复：手动触发 compaction
  若确认版本堆积且自动 compaction 未正常执行，可在业务低峰期手动触发全量合并：

  ADMIN COMPACT TABLE your_database.your_table WITH (type='BASE');
  

  注意：BASE compaction 资源消耗较大，需避开业务高峰。

• 排查 compaction 异常根因

  • 检查 BE 节点资源：确认内存、CPU 是否充足，资源不足会直接阻碍 compaction 执行
  • 检查表结构设计：分区、分桶过多，或高频 UPSERT/DELETE 操作会大幅增加 compaction 压力
  • 校验 compaction 配置：查看 FE 的 max_tablet_version_num、BE 的 compaction_thread_num、base_compaction_thread_num 等参数是否适配业务量级

• 后续优化建议

  • 根据业务量调整 compaction 相关参数，比如增大 BE 的 compaction 线程数
  • 优化表结构：合理规划分区、分桶，避免过多小分区
  • 调整导入策略：减少短时间内的小批量导入，尽量合并成批量任务以降低版本生成频率

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