Golang微服务在Swarm部署失败主因是监听地址、健康检查和DNS解析三处；必须监听0.0.0.0而非127.0.0.1，构建时设CGO_ENABLED=0和GOOS=linux，服务间调用用服务名而非localhost，健康检查用wget且路径需真实返回200。
直接用 docker service create 部署 Golang 微服务到 Swarm，只要镜像构建正确、端口绑定合理、网络配置到位，基本能一次跑通；但多数失败都卡在 Go 程序监听地址、健康检查超时、或跨服务 DNS 解析这三处。
Go 服务必须监听 0.0.0.0，不能只绑 127.0.0.1
Swarm 容器内运行的 Go 进程，如果写成 http.ListenAndServe("127.0.0.1:8080", handler)，会导致：外部请求进不来、HEALTHCHECK 失败、其他服务通过 overlay 网络也调不通。
正确做法是显式绑定到所有接口：
-
http.ListenAndServe(":8080", handler)（Go 默认等价于0.0.0.0:8080） - 或更明确地写成
http.ListenAndServe("0.0.0.0:8080", handler) - 若用了
gorilla/mux或chi，同样要确保底层http.Server绑定的是通配地址
Dockerfile 多阶段构建必须关 CGO，且指定 GOOS=linux
Alpine 镜像默认不带 glibc，如果编译时没关 CGO，运行时会报错：standard_init_linux.go:228: exec user process caused: no such file or directory —— 实际是缺动态链接库。
立即学习“go语言免费学习笔记（深入）”；
构建阶段关键参数不能漏：
-
CGO_ENABLED=0：禁用 C 调用，生成纯静态二进制 -
GOOS=linux：本地是 macOS/Windows 时尤其容易漏，否则生成的二进制无法在 Linux 容器里运行 -
-a -ldflags '-extldflags "-static"'：强制静态链接，进一步规避依赖问题
示例构建命令（放在 Dockerfile 的 builder 阶段）：
RUN CGO_ENABLED=0 GOOS=linux go build -a -ldflags '-extldflags "-static"' -o /usr/local/bin/app .
Swarm 内部服务发现靠 overlay 网络 + 服务名 DNS，不是 IP
两个服务（比如 usersvc 和 ordersvc）部署在同一个 Swarm overlay 网络中，它们互相调用时，**直接用服务名当 host**，例如 http://usersvc:8080/api/user。Swarm 内置 DNS 会自动解析为当前可用任务的容器 IP。
常见错误包括：
- 代码里硬编码了
localhost或127.0.0.1—— 容器内 localhost 指自己，不是目标服务 - 没显式创建自定义 overlay 网络，直接用默认
ingress—— ingress 仅用于发布端口，不推荐用于服务间通信 - 部署服务时没加
--network my-overlay，导致服务不在同一网络平面，DNS 解析失败
建议操作流程：
docker network create -d overlay my-overlay
docker service create --name usersvc --network my-overlay -p 8080:8080 your-registry/usersvc:v1
docker service create --name ordersvc --network my-overlay your-registry/ordersvc:v1
HEALTHCHECK 必须用 wget 或 nc，别用 curl
Alpine 镜像默认不带 curl，而 wget 是轻量且预装的（apk add --no-cache wget 可选，但通常已有）；用 curl 会导致健康检查直接失败退出，Swarm 认为任务不健康，反复重启。
健康检查命令示例（写在 Dockerfile 末尾）：
HEALTHCHECK --interval=15s --timeout=5s --start-period=40s --retries=3 \ CMD wget --quiet --tries=1 --spider http://localhost:8080/health || exit 1
注意点：
-
--start-period=40s给 Go 应用留足初始化时间（连 DB、加载配置等） - HTTP 探针路径
/health必须在 Go 服务里真实存在并返回 200 - 不要用
nc -z localhost 8080做 TCP 层检查 —— 它成功不代表 HTTP 服务就绪，容易误判
Swarm 部署 Golang 微服务真正难的不是命令本身，而是每个环节都依赖前一个环节的输出：镜像得静态可执行、进程得对外暴露、网络得连通、健康检查得能走通——漏掉任意一环，服务就会卡在 Preparing 或反复 Rejected，但错误日志往往只显示“task failed”，得一层层反向查。
