dosubot[bot] commented on issue #2839: URL: https://github.com/apache/incubator-hugegraph/issues/2839#issuecomment-3113091061
<!-- Answer --> 你遇到的 PDClient 连接报错（如 DEADLINE_EXCEEDED、UNAVAILABLE、Connection refused）通常说明 HugeGraph 无法和 PD（Placement Driver）节点建立 gRPC 连接，常见原因包括 PD 服务未启动、端口未监听、网络不通或配置不一致。可以按以下顺序排查： 1. 检查所有 PD 节点进程是否已启动，并且 8686 端口处于监听状态（用 `netstat -anp | grep 8686` 或 `lsof -i:8686` 查看）； 2. 确认配置文件（尤其是每台机器的 `hugegraph.properties`）完全一致，`raft.group_peers`、`pdserver.address`、`raft.address`、`grpc.host/port` 等参数必须包含所有节点的正确 IP 和端口，且不能有遗漏或冲突，且不能写在 `rest-server.properties` 里； 3. 如果 PD 和 Store 不在同一台机器，配置里不能用 127.0.0.1，必须用实际内网 IP； 4. 检查网络和防火墙设置，确保各节点间端口互通； 5. Store 节点首次启动前必须执行 `init-store.sh`，且 RocksDB 数据目录不能被其他进程占用（否则会报 lock 错）； 6. 检查 PD 和 Store 节点日志，关注 raft 选主、注册超时、分区分配失败等报错，能帮助定位问题； 7. 如果服务器内存不足，PD 进程可能被系统 kill（可用 `journalctl -k | grep -i 'killed process'` 检查）； 8. 确保所有组件（PD、Store、Server）版本一致，否则也会导致连接失败。 详细排查建议可参考 [相关社区经验](https://github.com/apache/incubator-hugegraph/issues/2830) 和 [配置一致性说明](https://github.com/apache/incubator-hugegraph/issues/2810)。 <!-- Dosu Comment Footer --> *To reply, just mention [@dosu](https://go.dosu.dev/dosubot).* --- <sup>How did I do? [Good](https://app.dosu.dev/response-feedback/87de496c-4fa2-48d7-bb52-1c67f0fc2add?feedback_type=great_response) | [Irrelevant](https://app.dosu.dev/response-feedback/87de496c-4fa2-48d7-bb52-1c67f0fc2add?feedback_type=irrelevant_answer) | [Incorrect](https://app.dosu.dev/response-feedback/87de496c-4fa2-48d7-bb52-1c67f0fc2add?feedback_type=incorrect_sources) | [Verbose](https://app.dosu.dev/response-feedback/87de496c-4fa2-48d7-bb52-1c67f0fc2add?feedback_type=too_verbose) | [Hallucination](https://app.dosu.dev/response-feedback/87de496c-4fa2-48d7-bb52-1c67f0fc2add?feedback_type=hallucination) | [Report 🐛](https://app.dosu.dev/response-feedback/87de496c-4fa2-48d7-bb52-1c67f0fc2add?feedback_type=bug_report) | [Other](https://app.dosu.dev/response-feedback/87de496c-4fa2-48d7-bb52-1c67f0fc2add?feedback_type=other)</sup> [](https://app.dosu.dev/e5e246fa-a522-4d8a-ab3c-e2588b5b501b/ask?utm_source=githu b) [](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/2839) -- 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]
