hexuxu110 commented on issue #2830: URL: https://github.com/apache/incubator-hugegraph/issues/2830#issuecomment-3060691478
> HugeGraph 1.5.0 部署时 store 节点无法连接 PD（报 “PD unreachable”）通常有以下常见原因： > > 1. **配置不一致**：所有 PD、Store、Server 节点的配置（如 raft.group_peers、pdserver.address、raft.address、grpc.host/port、initial-store-list）必须完全一致，IP 和端口不能有遗漏或冲突，且 raft.group_peers 必须写在每个节点的 hugegraph.properties 文件里，不能写在 rest-server.properties 里，否则不会生效[[1]](https://github.com/apache/incubator-hugegraph/issues/2787)[[2]](https://github.com/apache/incubator-hugegraph/issues/2810)。 > 2. **PD 服务未启动或端口未监听**：请确认 PD 进程已启动，并且 127.0.0.1:8686 端口处于监听状态。可以用 `netstat -anp | grep 8686` 或 `lsof -i:8686` 检查。 > 3. **网络或端口冲突**：如果 PD 和 Store 不在同一台机器，127.0.0.1 只代表本机，需改为实际内网 IP。端口不能被其他进程占用。 > 4. **Store 未初始化或 RocksDB 被占用**：store 节点首次启动前需执行 `init-store.sh`，且不能有其他进程占用 rocksdb 数据目录（否则会报 lock 错误）[[3]](https://github.com/apache/incubator-hugegraph/issues/2766)。 > 5. **日志排查**：建议查看 PD 和 Store 节点日志，关注 raft 选主、注册超时、分区分配失败等报错，能帮助定位问题[[4]](https://github.com/apache/incubator-hugegraph/issues/2821)。 > 6. **版本一致性**：确保 PD、Store、Server 都是 1.5.0 版本，避免因版本不兼容导致连接失败[[5]](https://github.com/apache/incubator-hugegraph/pull/2797)。 > > 常见排查顺序建议： > > 1. 检查 PD 是否正常监听 8686 端口。 > 2. 检查 store 配置的 pdserver.address 是否和 PD 配置一致。 > 3. 检查 raft.group_peers、grpc.host/port、initial-store-list 等参数在所有节点是否一致。 > 4. 检查网络互通（尤其是跨主机部署时）。 > 5. store 节点首次启动前执行 init-store.sh，且 rocksdb 目录无其他进程占用。 > 6. 查看 PD 和 store 日志，定位更详细的错误原因。 > > 如果还有问题，可以贴出 PD 和 store 的详细日志，便于进一步分析。 > > _To reply, just mention [@dosu](https://go.dosu.dev/dosubot)._ > > How did I do? [Good](https://app.dosu.dev/response-feedback/7a1c88b3-69d7-4e45-bca9-4722c632f14e?feedback_type=great_response) | [Irrelevant](https://app.dosu.dev/response-feedback/7a1c88b3-69d7-4e45-bca9-4722c632f14e?feedback_type=irrelevant_answer) | [Incorrect](https://app.dosu.dev/response-feedback/7a1c88b3-69d7-4e45-bca9-4722c632f14e?feedback_type=incorrect_sources) | [Verbose](https://app.dosu.dev/response-feedback/7a1c88b3-69d7-4e45-bca9-4722c632f14e?feedback_type=too_verbose) | [Hallucination](https://app.dosu.dev/response-feedback/7a1c88b3-69d7-4e45-bca9-4722c632f14e?feedback_type=hallucination) | [Report 🐛](https://app.dosu.dev/response-feedback/7a1c88b3-69d7-4e45-bca9-4722c632f14e?feedback_type=bug_report) | [Other](https://app.dosu.dev/response-feedback/7a1c88b3-69d7-4e45-bca9-4722c632f14e?feedback_type=other) [](https://go.dosu.dev/discord-bot) [](https://twitter.com/intent/tweet?text=%40dosu_ai%20helped%20me%20solve%20this%20issue!&url=https%3A//github.com/apache/incubator-hugegraph/issues/2830) -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
