监听地址必须设为0.0.0.0而非127.0.0.1；镜像需多阶段构建+CGO_ENABLED=0+scratch/alpine；Deployment的labels与selector必须严格一致；/healthz和/readyz端点须真实存在、路径精确匹配且含超时控制。
监听地址必须是 0.0.0.0，不能写 127.0.0.1
边缘节点（比如树莓派、Jetson 或工控网关）资源有限，Kubernetes 的 Pod 网络模型没变：每个 Pod 有独立 IP，但容器内 localhost 仍只指向自己。如果你的 Go 服务写成 http.ListenAndServe("127.0.0.1:8080", nil)，Service 流量根本进不来，kubectl port-forward 也连不上，现象是 Pod 显示 Running 但所有请求超时。
正确做法是显式监听所有接口：http.ListenAndServe(":8080", nil)，或更稳妥地读环境变量：port := os.Getenv("PORT") + http.ListenAndServe(":" + port, nil)。边缘设备上别硬编码端口，留给 Deployment 通过 env 注入。
Dockerfile 必须用多阶段 + CGO_ENABLED=0 + scratch/alpine
边缘节点通常用 ARM 架构、内存小、存储紧张，镜像大 = 启动慢 + 拉取失败 + 磁盘撑爆。常见错误是直接用 golang:alpine 运行，结果镜像带完整 Go 工具链和 musl libc 依赖，体积超 100MB。
必须用多阶段构建：
立即学习“go语言免费学习笔记（深入）”；
- 构建阶段：
FROM golang:1.22-alpine AS builder，RUN CGO_ENABLED=0 GOOS=linux GOARCH=arm64 go build -a -ldflags '-extldflags "-static"' -o main . - 运行阶段：
FROM scratch（ARM64 支持良好）或FROM arm64v8/alpine:latest（若需apk装 ca-certificates） -
COPY --from=builder /app/main /main，USER 65532:65532，EXPOSE 8080，CMD ["/main"]
注意：CGO_ENABLED=0 是关键——否则在 scratch 上运行会报 no such file or directory（实际是找不到 glibc 动态库）。
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
Deployment 的 labels 和 selector 必须一字不差
边缘集群节点少、部署频次高，一旦 selector.matchLabels 和 Pod template 的 metadata.labels 不一致，Deployment 就卡住，报错类似 invalid label selector 或 field is immutable。这不是警告，是硬性校验失败，kubectl apply 直接拒绝。
检查点：
- 两边都写
app: edge-agent，不能一边是app: edge-agent，另一边是app: EdgeAgent - 不要多空格、不要大小写混用、不要漏掉引号导致 YAML 解析为布尔值（如
enabled: true被误读） - 边缘场景建议加
nodeSelector锁定到edge类型节点：node-role.kubernetes.io/edge: ""
/healthz 和 /readyz 端点必须真实存在且路径严格匹配
边缘节点网络不稳定、依赖服务（如 MQTT broker、本地 SQLite）可能启动慢，Kubernetes 探针失败会导致 Pod 反复重启，日志里只看到 CrashLoopBackOff，但根本原因在探针 404 或超时。
你的 Go 代码里得有：
http.HandleFunc("/healthz", func(w http.ResponseWriter, r *http.Request) {
w.WriteHeader(200)
})
http.HandleFunc("/readyz", func(w http.ResponseWriter, r *http.Request) {
// 检查本地 DB 或 MQTT 连通性，超时控制在 10 秒内
if err := checkLocalDB(); err != nil {
w.WriteHeader(503)
return
}
w.WriteHeader(200)
})
同时确保 Deployment YAML 中的 livenessProbe.httpGet.path 和 readinessProbe.httpGet.path 完全一致（比如都写 /healthz），且 containerPort 和 Go 监听端口一致（比如都是 8080）。路径名错一个字符，探针就永远 404。
ca-certificates，导致 Go 程序访问 HTTPS 外部服务（如云平台 API）时 TLS 握手失败。这两处问题在资源受限的边缘环境里，比功能 bug 更早暴露。 
