调用WhatsApp Business API /v1/contacts报wacore:6251连接拒绝错误

针对调用联系人接口返回Connection refused. Please check if wacore is running: wacore:6251、但wacore容器显示运行中的问题，按以下顺序排查：

• 先验证跨容器网络连通性：容器处于running状态不代表容器内服务正常、也不代表同栈容器能正常通信。进入承载WA API接口服务的容器，直接测试对wacore 6251端口的连通性：

docker exec -it <你的WA API接口容器ID/名称> sh -c "nc -zv wacore 6251"

如果命令返回连接失败，说明两个容器不在同一个Docker私有网络下，或者wacore内部服务没正常监听端口。

• 核查wacore内部服务实际运行状态：执行以下命令检查wacore容器内6251端口是否真的在监听：

docker exec -it <wacore容器ID/名称> sh -c "netstat -tulpn | grep 6251"

如果没有返回0.0.0.0:6251的监听记录，说明wacore进程虽然容器没退出，但实际启动失败/未完成初始化，直接拉取最近200行日志定位启动错误：

docker logs <wacore容器ID/名称> --tail 200

v2.41.x版本wacore启动失败的常见原因包括：挂载的数据目录权限不足、账号注册流程未完成、内置数据库初始化异常、授权校验不通过。

• 核对部署配置：如果是用docker-compose部署，确认wacore服务和API接口服务归属同一个Docker网络，不存在网络隔离；6251是容器内部通信用端口，不需要映射到宿主机，错误的端口映射会导致端口冲突、服务监听异常。
• 等待初始化完成：/v1/health路由返回正常不代表wacore完成全量初始化，wacore启动后需要加载账号数据、完成服务注册，通常需要2-5分钟，等日志中出现wacore service started on port 6251类提示后再调用接口测试，初始化未完成时调用业务接口就会报连接拒绝。
• 修复偶发启动异常：v2.41.2版本存在小概率启动时服务注册失效的bug，如果前面检查都正常，直接重启wacore容器，等待2分钟服务拉起后再测试即可：

docker restart <wacore容器ID/名称>

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