用途：面向 Apache Doris 集群部署与启动阶段的问题排查，聚焦 FE/BE 启动失败、端口占用、网络误配、元数据损坏与后端节点添加删除异常。
主要能力：资料列出六类常见原因并可对照证据定位——A 端口冲突（Address already in use）；B priority_networks 配置错误导致 brpc 连接被拒或绑定错误网卡；C meta_dir / storage_root_path 不可写（Permission denied 或路径不存在）；D FE 元数据损坏（崩溃后无法启动，出现 meta/image.* 错误）；E 混合版本集群导致 FE-BE 间 thrift/brpc 协议不匹配；F DNS/hostname 解析问题（UnknownHostException、BE 心跳上报错误地址）。
排查方式：先做约 10 分钟初步分诊。用 curl 检查 FE 状态（http://$FE:8030/api/bootstrap 与 api/health）、BE 状态（http://$BE:8040/api/health），用 ss -tlnp | grep -E "8030|8040|8060|9030" 检查端口，并通过 SQL SHOW FRONTENDS\G 与 SHOW BACKENDS\G 查看集群成员。
默认端口：FE HTTP 8030（http_port）、BE HTTP 8040（webserver_port）、BE brpc 8060（brpc_port）、FE MySQL 9030（query_port）、FE Edit log 9010（edit_log_port）。端口占用可先 fuser -k 8060/tcp 清理残留 BE brpc 进程后重启。
priority_networks：需在 be.conf 中精确匹配单一子网，如 priority_networks = 10.0.0.0/24；可用 curl -s "http://$BE:8040/api/health" | grep -o '"ip":"[^"]*"' 查看实际绑定 IP。校验标准是 SHOW BACKENDS 中的 IP 必须能被每个 FE 和其他 BE 在 8060 端口访问。
FE 元数据恢复：检查 fe/doris-meta/image/ 与 fe/doris-meta/bdb/。若 bdb 损坏且该节点为 follower/observer，可先从集群移除该 FE、清空 doris-meta/、再以新 follower 重新加入（ALTER SYSTEM ADD FOLLOWER "host:9010"）。资料特别提示：绝不可在最后一个健康的 Master FE 上删除 doris-meta/。
限制：资料仅提供原因分类、证据与排查命令，未提供自动化脚本、版本兼容性范围或完整恢复流程，具体处置需结合实际环境判断。