consul客户端初始化连不上本地agent，因默认连接http://localhost:8500，但agent可能未启用http接口、监听地址不匹配（如仅绑127.0.0.1）、docker中localhost指向容器自身，或acl需token；应先确认agent运行并用curl测试，再显式配置host/port。
Consul客户端初始化时为什么连不上本地Agent？
默认情况下 consul.Consul() 会尝试连接 http://localhost:8500，但很多开发环境里 Consul Agent 并没以 dev 模式启动，或者端口被占用了。常见错误是抛出 ConnectionError 或卡在连接超时。
- 先确认 Consul Agent 是否运行：
consul agent -dev -client=0.0.0.0 -bind=127.0.0.1（注意-client控制 HTTP 接口监听地址，不是服务发现地址） - Python 初始化时显式传参更可靠：
consul.Consul(host="127.0.0.1", port=8500, scheme="http") - 如果用 Docker 启 Consul，宿主机 Python 连不上
localhost，得换成host.docker.internal（Mac/Win）或容器网络 IP（Linux）
Flask服务启动后如何注册到Consul？
注册必须在 Flask 应用真正监听请求前完成，否则 Consul 健康检查会失败。不能放在 app.run() 之后，也不能只靠装饰器或配置自动触发。
- 推荐在
if __name__ == "__main__":块里手动调用注册逻辑，确保顺序可控 - 注册时至少提供
service_id、name、address、port和check；service_id必须唯一，建议拼入主机名或 PID 避免多实例冲突 - 健康检查 URL 要真实可访问，比如用 Flask 的
/health端点，且返回 HTTP 200；别写成/或不存在路径，否则 Consul 会标记为critical - 示例注册调用：
consul_client.agent.service.register(name="user-svc", service_id="user-svc-12345", address="192.168.1.10", port=5000, check={"http": "http://192.168.1.10:5000/health", "interval": "10s"})
从Consul获取其他服务地址时为什么总返回空列表？
consul_client.health.service("xxx") 返回空，不一定是没注册成功，更可能是服务名不匹配、状态过滤过严，或查询用的 Consul Agent 不在同一个数据中心。
- 查服务前先确认注册的服务名是否完全一致（大小写、中横线、下划线都敏感）
- 默认只返回
passing状态节点，加参数passing=False可看全部，再判断是不是健康检查失败了 - 跨 DC 查询需显式指定
dc参数，如consul_client.health.service("order-svc", dc="prod-dc") - 返回结果里真正可用的地址在
node["Address"]和service["Port"]，不是service["Address"]（后者为空时才 fallback 到 node 地址）
服务下线时忘记 deregister 会导致什么问题？
Flask 进程退出时若没主动注销，Consul 会一直保留该服务条目，健康检查持续失败，直到 TTL 过期（默认 1 小时），期间其他服务可能误选到已下线节点。
- 用
atexit.register()或信号捕获（如signal.signal(signal.SIGINT, ...)）确保清理 - 注销只需一行：
consul_client.agent.service.deregister(service_id="user-svc-12345") - 更稳妥的做法是配合 TTL 类型的健康检查：注册时设
"check": {"ttl": "30s"}，然后定期调用consul_client.agent.check.ttl_pass("service:xxx")续约；这样即使进程异常退出，Consul 也会自动剔除
-client 和 -bind 区别，这是最常卡住的地方。Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
