flask需借助consul实现服务注册与发现，解决容器化环境中动态寻址问题；注册须传唯一service_id、正确address和健康检查端点，发现需调用c.health.service()获取可用实例。
Flask 本身不提供服务注册与发现能力，直接跑 app.run() 的实例对其他服务不可见——它既没告诉 Consul 自己在哪，也没主动去查别人在哪。用 Consul 不是为了“高大上”，而是解决动态寻址这个实际痛点。
Consul 能让 Flask 服务在容器/集群里真正“被找到”
本地开发时 127.0.0.1:5000 写死没问题，但一进 Docker 或 K8s，IP 和端口就变成动态的。Consul 把服务地址、健康状态、标签等元数据存起来，其他服务调用前查一下就能拿到真实可连的实例列表。
- 注册必须传
service_id（唯一），否则同一服务多次启动会冲突；name是发现时用的服务名，可复用 -
address不能填127.0.0.1，Docker 环境下推荐用host.docker.internal（Mac/Win）或宿主机真实 IP（Linux） - 健康检查端点（如
/health）必须返回 HTTP 200，且 Consul agent 要能从它所在网络访问到该地址
python-consul 比裸发 HTTP 请求更可控
用 consul.Consul() 初始化客户端比手写 requests.post() 到 http://localhost:8500/v1/agent/service/register 更稳：
- 自动处理连接重试、超时、JSON 序列化
- 支持
consul.Check.http()这类封装好的健康检查构造器，避免手动拼check字典出错 - 异常类型明确：
consul.ConsulException可捕获，Consul 不可用时不卡住 Flask 启动 - 初始化时显式传
host和port，避免默认连localhost:8500在容器网络里失败
服务发现逻辑必须放在调用方，不能只靠注册
注册只是单向动作，服务消费者得自己查 Consul 才能拿到目标地址。常见错误是只做了注册，却还在代码里硬编码 http://order-service:5000。
- 查健康实例要用
c.health.service('order-service', passing=True)，不是c.health.service('order-service') - 返回结果是列表，得取
services[0]['Service']['Address']和['Port']拼 URL，别直接用字典键名写死 - 如果用 Gunicorn/Uvicorn，注册不能放
if __name__ == '__main__':里——得改用on_starting钩子，否则 worker 进程可能重复注册
最易被忽略的一点：注册时机。必须确保 Flask 已监听端口、/health 路由已就绪，再调用 c.agent.service.register()。早了 Consul 会立刻标记为不健康；晚了其他服务可能已经发起调用，造成短暂 502。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
