用 docker-compose 搭 Go 微服务实验环境最稳,通过独立 Dockerfile(alpine 基础镜像)、服务名互调(Docker 内置 DNS)、环境变量传地址、0.0.0.0 监听、重试逻辑及合理日志调试,避免端口冲突与“本地能跑”问题。

直接用 docker-compose 搭多服务 Go 微服务实验环境最稳,不用折腾本地 GOPATH 或端口冲突,也避免 “在我机器上能跑” 类问题。
用 docker-compose 启动多个 Go 服务并互通
每个 Go 服务写独立的 Dockerfile,统一用 alpine 基础镜像减小体积;docker-compose.yml 中通过服务名(如 auth、user)互相调用,Docker 内置 DNS 自动解析 —— 不用手动记 IP 或改 hosts。
- 所有服务暴露的端口只对宿主机映射(如
8081:8080),容器间通信走内部网络,用服务名 + 默认端口(如http://user:8080/api/users) -
depends_on只控制启动顺序,不等待服务就绪;需在 Go 代码里加重试逻辑或用wait-for-it.sh - Go 服务监听必须设为
0.0.0.0:8080,不能写localhost:8080,否则容器内其他服务连不上
version: '3.8'
services:
auth:
build: ./auth
ports: ["8081:8080"]
environment:
- USER_SERVICE_URL=http://user:8080
user:
build: ./user
ports: ["8082:8080"]
environment:
- DB_HOST=postgres
- DB_PORT=5432
postgres: image: postgres:15-alpine environment: POSTGRES_DB: demo POSTGRES_PASSWORD: pass volumes:
- pgdata:/var/lib/postgresql/data
volumes: pgdata:
Go 服务里怎么安全读取跨服务地址
别硬编码 "http://user:8080",从环境变量读,再做基础校验。Docker Compose 传进来的地址是可靠的,但本地开发时可能为空,得 fallback 或 panic。
- 用
os.Getenv("USER_SERVICE_URL")读,空值时直接log.Fatal,比运行时报connection refused更早暴露问题 - 如果要用 HTTP 客户端发请求,建议封装一个带默认超时和重试的
*http.Client,别用全局http.DefaultClient - 服务发现不是必需的——实验环境没注册中心,靠 Docker 网络 + 环境变量足够
本地调试和容器日志怎么同步看
开发时别只盯着 docker-compose logs -f,容易漏掉编译错误或 panic 前的 goroutine trace。推荐组合使用:
立即学习“go语言免费学习笔记(深入)”;
- 在每个 Go 服务的
main.go开头加log.SetFlags(log.LstdFlags | log.Lshortfile),方便定位日志来源 - 用
docker-compose up --build启动,加--build确保每次改了代码都重新构建镜像 - 想进容器调试?
docker-compose exec auth sh进去查进程、抓包、看 /tmp 下临时文件 - VS Code 装 Remote-Containers 插件,直接 attach 到容器里 debug,断点、变量、调用栈全有
真正麻烦的不是启动几个容器,而是服务间超时设置不一致、HTTP 客户端没设 timeout 导致请求卡死、或者环境变量名拼错导致 fallback 到 localhost —— 这些问题在 docker-compose 里比本地更难一眼发现。










