用 docker-compose 搭 Go 微服务实验环境最稳,通过独立 Dockerfile(alpine 基础镜像)、服务名互调(Docker 内置 DNS)、环境变量传地址、0.0.0.0 监听、重试逻辑及合理日志调试,避免端口冲突与“本地能跑”问题。
直接用 docker-compose 搭多服务 Go 微服务实验环境最稳,不用折腾本地 GOPATH 或端口冲突,也避免 “在我机器上能跑” 类问题。
每个 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
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:
postgres: image: postgres:15-alpine environment: POSTGRES_DB: demo POSTGRES_PASSWORD: pass volumes:
volumes: pgdata:
别硬编码 "http://user:8080",从环境变量读,再做基础校验。Docker Compose 传进来的地址是可靠的,但本地开发时可能为空,得 fallback 或 panic。
os.Getenv("USER_SERVICE_URL") 读,空值时直接 log.Fatal,比运行时报 connection refused 更早暴露问题*http.Client,别用全局 http.DefaultClient
开发时别只盯着 docker-compose logs -f,容易漏掉编译错误或 panic 前的 goroutine trace。推荐组合使用:
main.go 开头加 log.SetFlags(log.LstdFlags | log.Lshortfile),方便定位日志来源docker-compose up --build 启动,加 --build 确保每次改了代码都重新构建镜像docker-compose exec auth sh 进去查进程、抓包、看 /tmp 下临时文件
真正麻烦的不是启动几个容器,而是服务间超时设置不一致、HTTP 客户端没设 timeout 导致请求卡死、或者环境变量名拼错导致 fallback 到 localhost —— 这些问题在 docker-compose 里比本地更难一眼发现。