“Lookup failed”错误表示Broker无法为Topic定位服务实例，主因是ZooKeeper元数据不一致、Broker未注册、网络不通或Namespace策略限制，而非BookKeeper宕机；需依次检查ZK路径、Broker健康状态、Bookie连通性、网络DNS及命名空间配置。

如果您在使用 Pulsar 时遇到 “Lookup failed” 错误，该错误通常表示 Broker 无法为指定 Topic 定位到负责服务的 Broker 实例，而非直接表明 BookKeeper 节点已挂。Lookup 过程依赖 ZooKeeper 中的元数据一致性、Broker 健康状态注册以及网络连通性。以下是排查与修复此问题的多种方法：

一、检查 ZooKeeper 元数据一致性

ZooKeeper 是 Pulsar 集群元数据（如 topic 所属 broker、bookie 列表、namespace 策略等）的核心协调服务。若其节点异常或数据不一致，会导致 lookup 请求无法获取有效路由信息。

1、使用 zkCli.sh 连接 ZooKeeper 集群，执行 ls /ledgers 和 ls /brokers，确认路径存在且子节点非空。

2、检查 /brokers 路径下是否包含当前活跃 Broker 的临时节点（格式为 ip:port），缺失则说明对应 Broker 未成功注册或已意外退出。

3、执行 get /namespace///persistence，验证 persistence 策略是否被正确写入，避免因策略为空导致 lookup 跳过路由计算。

二、验证 Broker 服务健康状态

Lookup 请求由客户端发起后，首先由任意可用 Broker 接收并执行路由查询；若该 Broker 自身状态异常（如未完成初始化、心跳丢失、线程阻塞），将无法响应 lookup 请求。

1、执行 pulsar-admin brokers list，确认返回结果中包含所有预期的 Broker 地址。

2、访问 Broker 的 metrics 端点（如 http://:8080/metrics），检查 pulsar_broker_lookup_requests_total 和 pulsar_broker_lookup_failures_total 指标是否持续增长。

3、查看 Broker 日志中是否存在 WARN 或 ERROR 级别日志，例如 “Failed to find owner for topic” 或 “Unable to acquire topic ownership”，此类日志指向内部 ownership 管理异常。

三、确认 BookKeeper 节点可访问但不直接导致 Lookup 失败

BookKeeper 节点（Bookie）宕机本身不会触发 Lookup failed，因为 lookup 阶段不涉及 Bookie 通信；但若 Bookie 集群整体不可用或 Ensemble 不足，可能导致 Broker 在尝试创建新 Ledger 时卡住，间接影响后续 topic 初始化流程，进而使 lookup 超时失败。

1、运行 bookiesanity 工具验证 Bookie 连通性：bin/bookiesanity -zk -bookie :3181。

2、执行 pulsar-admin bookies list，确认返回的 Bookie 列表与实际部署数量一致，且无 FAILED 状态条目。

3、检查 BookKeeper 客户端配置中 ensembleSize（WQ）、writeQuorum（WQ）、ackQuorum（AQ）是否满足 AQ ≤ WQ ≤ 书签数，否则新建 topic 时 Ledger 创建会失败，阻塞 lookup 后续流程。

四、排查网络与 DNS 解析问题

Lookup 请求需完成从客户端 → Broker → ZooKeeper → Broker 的多次跨节点调用，任一环节的网络中断、防火墙拦截或 DNS 解析失败均会导致 lookup 超时或返回空路由。

1、在 Broker 节点上执行 telnet 2181，验证 ZooKeeper 端口可达性。

2、在客户端机器上执行 nslookup ，确认 DNS 解析结果与实际部署 IP 一致，避免因 hostname 写错或解析缓存污染导致连接错误地址。

3、检查 Broker 配置文件 conf/broker.conf 中的 advertisedAddress 是否设置为客户端可访问的 IP 或域名，若设置为 localhost 或内网地址，外部客户端 lookup 必然失败。

五、检查 Namespace 级别策略限制

Namespace 配置中的权限控制、topic 分发策略或自动创建开关可能阻止 topic 路由信息生成，从而造成 lookup 返回空结果。

1、执行 pulsar-admin namespaces get-policies /，确认 autoTopicCreationOverride.enabled 字段为 true，否则首次 lookup 新 topic 将失败。

2、检查 bundles 分配情况：pulsar-admin namespaces get-bundles /，若返回空或数量异常，说明 namespace 未完成初始分片划分，Broker 无法确定 topic 所属 bundle。

3、确认该 namespace 下无 active 且 conflict 的 persistence 策略，例如同时设置了 bookies=xxx 和 replicationFactor=1，而实际 Bookie 数量不足，将导致 topic 初始化失败并静默跳过 lookup 注册。