端口冲突应优先用环境变量（如PORT）或本地自动探测，Docker中调用需改用host.docker.internal等正确地址，配合air热重载和OpenTelemetry链路追踪实现高效调试。
端口冲突了怎么办？别硬编码，用环境变量或自动探测
本地启动多个微服务时，listen tcp :8080: bind: address already in use 是最常撞上的墙。直接在代码里写死 http.ListenAndServe(":8080", nil)，改一个服务就得翻三四个文件去同步端口，极易遗漏。
- 开发阶段优先用环境变量：在
main.go里读os.Getenv("PORT")，fallback 到默认值（如"8080"），启动时统一加前缀：PORT=8082 go run main.go - 更激进但实用的做法是自动探测端口（仅限本地）：从
8080开始尝试net.Listen("tcp", ":8080")，失败则递增，直到成功——注意别用在生产，K8s 或 Consul 都要求显式声明端口 - 别忘了检查
go.mod里有没有其他服务也悄悄占了同个端口（比如健康检查 endpoint、pprof、metrics），它们也得走环境变量控制
服务间调用连不上？localhost 在 Docker 里根本不是你想象的 localhost
你在宿主机跑 auth-service，Docker 容器里的 order-service 写 http://localhost:8081 去调它，结果永远超时——因为容器里的 localhost 指的是容器自己，不是你的 Mac/Windows/Linux 主机。
- 纯本地多进程（没 Docker）：所有服务监听
0.0.0.0:$PORT，调用方统一用http://127.0.0.1:$PORT（别用localhost，某些系统会走 IPv6 导致延迟甚至失败） - Docker Desktop（macOS/Windows）：调用方地址换成
http://host.docker.internal:$PORT - Docker on Linux：用
http://172.17.0.1:$PORT（Docker 默认 bridge 网关） - 无论哪种，
http.Client必须设超时：&http.Client{Timeout: 5 * time.Second}，否则断点卡住几秒就误判成网络故障
改一行代码就要 Ctrl+C + go run？用 air 实现热重载
手动重启不仅慢，还容易漏掉 go mod tidy、忘重载环境变量、或者把两个服务塞进同一个终端脚本里导致崩了一个全瘫。
- 装
air：go install github.com/cosmtrek/air@latest，然后在每个服务根目录下运行air - 配
.air.toml显式指定构建命令和环境变量，比如：[build] cmd = "go build -o ./app ." bin = "./app" include_dir = ["."] exclude_dir = ["tmp", "vendor", ".git"] env = ["PORT=8082"]
- 严禁在
init()里做阻塞操作（比如连 DB、发 HTTP 健康探针），否则air重启时会卡死在初始化阶段，看起来像“没反应”
跨服务请求链路断了？不接 OpenTelemetry，调试就是靠猜
用户反馈“下单失败”，你查 order-service 日志只看到 failed to call payment-service，但不知道是超时、400 还是 panic；再切到 payment-service 日志，时间戳对不上，上下游 request ID 又没透传——这就是没链路追踪的日常。
立即学习“go语言免费学习笔记（深入）”；
- 本地最小化接入：用
otelhttp.NewHandler包裹 HTTP handler，用otelhttp.NewClient包裹调用客户端 - Jaeger 一键拉起：
docker run -d --name jaeger -p 16686:16686 jaegertracing/all-in-one:1.45，浏览器打开http://localhost:16686就能看完整调用树 - 关键前提是
context要全程透传：所有 HTTP handler 和 client 调用都必须带ctx，不能丢掉；中间件里用req = req.WithContext(ctx)补上
环境变量、端口、context 透传这三件事，看着琐碎，但只要漏掉一个，本地多服务调试就会退化成“日志拼图游戏”。真正省时间的不是工具多炫，而是每次启动前确认这三项是否对齐。
