consul健康检查需显式启用且严格遵循配置规范：必须设置-enable-local-script-checks=true（1.11+），检查脚本须绝对路径、可执行、纯utf-8输出；http检查200–499视为成功；跨dc状态依赖wan gossip同步，需确保serf wan members连通；脚本超时须≤check.interval的70%，禁止内部重试；consul watch不适用于精准健康事件响应。
Consul agent 启动时必须开启健康检查支持
Consul 默认启动的 consul agent 不会自动运行健康检查，除非显式启用。常见错误是只配置了服务注册却没开检查机制，导致服务明明宕了，UI 里仍显示 passing。
关键点在于：-enable-script-checks=true（旧版）或更推荐的 -enable-local-script-checks=true（1.11+），且需配合 -config-dir 指向含检查定义的目录。
- 脚本检查必须有可执行权限，且路径为 agent 可读（不能用
~/xxx.sh，要用绝对路径如/opt/consul/checks/api-health.sh） - HTTP 检查依赖服务响应码：200–499 都算成功，5xx 才触发告警 —— 这和多数人直觉相反，容易误判
- 如果检查脚本输出含非 UTF-8 字符（比如某些中文日志截取），Consul 会静默跳过该检查，日志里只报
failed to decode check output
跨数据中心健康检查必须走 WAN Gossip 和 RPC 转发
Consul 的健康检查本身不跨 DC 自动同步。所谓“数据中心级别检查”，实际是指：A 数据中心的 client agent 把检查结果上报给本地 server，server 再通过 WAN gossip + RPC 将状态同步到其他 DC 的 server 集群。
这意味着你不能在 B DC 的 agent 上直接 ping A DC 的服务 IP 做本地检查 —— 网络不通、防火墙拦截、延迟高都会让检查失真。
Zynq‑7000 / Zynq UltraScale+ 硬件调试技能。适用于 Xilinx Zynq（Cortex‑A9/A53 + FPGA）Linux 环境，调试 I2C、I2S、UART、GPIO 等外设。包括设备树配置、内核驱动、用户空间调试工具、交叉编译和常见问题排查，支持 PetaLinux 开发。
- 正确做法是：每个 DC 内部部署独立检查逻辑（比如各自调本地 API / 端口探测），再靠 Consul 自带的
consul catalog services -dc=other-dc查远程服务列表，结合consul health service mysvc -dc=other-dc获取其聚合健康状态 - WAN 连接必须稳定：若两个 DC 的 server 间
serf wan members显示failed，健康状态就永远不会同步过去 -
consul operator raft list-peers -dc=other-dc要能返回对方 DC 的 server 列表，否则元数据同步链路已断
自定义健康检查脚本要避免阻塞和超时失控
Consul 对检查脚本有硬性 timeout 控制（默认 10s），但这个值不能在脚本里 override。常见翻车场景是脚本内部用 curl --timeout 30，结果 Consul 在 10s 时直接 kill 进程，留下 critical 状态卡死。
- 所有网络操作必须自带超时，且总耗时 ≤
check.interval的 70%（比如 interval 是 30s，脚本逻辑应控制在 20s 内完成） - 不要在检查脚本里做重试：Consul 本身会按 interval 重试，脚本内重试只会拉长单次检查时间，挤占后续检查窗口
- 敏感操作（如 DB 连接）建议加
timeout -s SIGTERM 8s psql -c "SELECT 1"，而不是依赖进程自身超时 - 输出必须是纯文本：Consul 会解析 stdout 第一行作为状态摘要，第二行起全当备注；如果第一行为空或全是空格，会被识别为
unknown
consul watch 不适合替代健康检查事件监听
有人想用 consul watch -type=checks -handler=./notify.sh 实时响应状态变更，但这不是健康检查的正经用法 —— 它监听的是 KV 或 checks 的变更事件，粒度粗、延迟高（默认 30s 轮询）、且无法区分是真实故障还是临时抖动。
真正需要快速响应时，应该用 Consul 的 health service API 配合短轮询，或集成 Prometheus + consul_exporter 做指标化监控。
-
consul watch的 handler 进程崩溃后不会自动重启，需额外用 systemd 或 supervisor 管理 - 它不保证事件顺序：同一服务多个检查同时变 critical，
watch可能乱序推送 - 跨 DC 场景下，
watch -type=checks默认只监听本 DC，加-dc=other-dc参数也不生效 —— 这是设计限制，不是 bug
serf wan members 早就掉线了，没人看。
