Doris查询报错：Failed to get scan range, no queryable replica found in tablet: xxxx

• 先查目标tablet的详细状态
  执行命令 ADMIN SHOW TABLET xxxx;，重点看ReplicaState（正常应为NORMAL）、IsQueryable（正常为true）、LastFailedReason这几个字段，直接定位副本不可查询的具体原因。

• 检查副本所在BE节点状态
  用 SHOW BACKENDS; 查看对应副本所在BE节点的Alive状态：

  • 如果节点挂了，先尝试重启BE，或者根据集群情况替换故障节点；
  • 如果节点存活但副本异常，检查节点磁盘是否已满、存储目录权限是否正常，同时查看BE日志（通常在部署目录的log/be.log）里的报错信息，找具体异常点。

• 手动修复异常副本
  如果副本状态是DEAD或UNAVAILABLE：

  • 先尝试自动修复：执行 ADMIN REPAIR TABLE your_table_name TABLET xxxx;，让Doris自动重建异常副本；
  • 若自动修复失败，可手动删除异常副本再重建：
    1. 删除异常副本：ADMIN DROP REPLICA xxxx FROM BACKEND "be_node_ip:heartbeat_service_port";
    2. 再次执行修复命令触发重建。

• 校验表的副本配置合理性
  用 SHOW CREATE TABLE your_table_name; 查看REPLICATION_NUM值，确保副本数不超过集群BE节点总数（比如BE有3个节点，副本数别设成4），如果配置不合理，用ALTER TABLE your_table_name SET ("replication_num" = "3");调整。

• 排查集群元数据一致性
  若以上操作都无效，执行 ADMIN CHECK TABLE your_table_name; 检查表元数据完整性；或者尝试重启FE节点刷新元数据（高可用集群请先重启备FE，切换主FE后再重启原主FE，避免服务中断）。

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