GoLand不支持多运行配置模拟微服务启动顺序，应使用shell脚本统一管理依赖等待、环境设置与服务启停，并配合独立Go Build配置实现单服务调试。
GoLand里不能靠“多开几个运行配置”来模拟微服务启动顺序
微服务调试时，你手动点五次绿色三角、按特定顺序点——这不可靠，也难复现。GoLand本身不提供“启动队列”或“依赖启动”机制，所谓“自定义启动顺序”，本质是把多个服务的启动逻辑收束到一个可控入口，再由IDE统一触发。
常见错误现象：openim-api 启动时报 connection refused，不是端口被占，而是它依赖的 openim-rpc 还没起来；或者你改了 openim-msggateway 的配置，却忘了同步更新 openim-api 的环境变量，结果调试半天发现是环境不一致。
- 不要为每个服务单独建一个Go Build配置然后手动点击——临时配置会快速过期，且无法保证执行顺序
- 不要在Program arguments里硬编码多个
go run命令拼接——GoLand不会解析shell语法，只会把它当单个参数传给主程序 - Working directory必须对齐每个服务的真实需求：比如
openim-api读./config/config.yaml，那它的Working directory就得是$ProjectFileDir$/cmd/openim-api，而不是项目根目录
用 shell 脚本封装启动顺序，再让 GoLand 调用它
这是目前最稳定、可复现、易协作的做法。脚本负责等待依赖就绪（如端口监听）、设置各自环境、按序拉起服务，GoLand只负责执行这个脚本。
示例脚本 dev-start.sh（放在项目根目录）：
#!/bin/bash # 等待 RPC 服务端口就绪（避免 race condition） echo "Waiting for openim-rpc on :10001..." while ! nc -z localhost 10001; do sleep 1; done <h1>启动 API 服务（后台运行，不阻塞）</h1><p>cd cmd/openim-api && GOPROXY=<a href="https://www.php.cn/link/b6512ba2ef13d7241ba28dbf20bff5a7">https://www.php.cn/link/b6512ba2ef13d7241ba28dbf20bff5a7</a> LOG_LEVEL=debug go run main.go --port=10002 &</p><h1>启动消息网关（同样后台）</h1><p>cd cmd/openim-msggateway && LOG_LEVEL=debug go run main.go --port=10003 &</p><p>echo "All services started." wait
关键点：
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
-
nc -z localhost 10001是轻量级端口探测，比 sleep 3s 更可靠 - 每个
go run前显式设置LOG_LEVEL、GOPROXY等变量，避免和系统环境冲突 -
cd cmd/xxx && go run ...确保 Working directory 正确，不用在GoLand里反复切换
在 GoLand 中配置 Shell Script 运行配置并注入调试能力
直接运行脚本只能看到日志流，没法打断点调试。你需要让 GoLand 把脚本里的某个服务“拎出来”单独调试，同时保持其他服务由脚本管理。
操作步骤：
- Run → Edit Configurations → + → Shell Script
- Name 填
dev-microservices - Script path 填
$ProjectFileDir$/dev-start.sh - Working directory 设为
$ProjectFileDir$（脚本内部已处理 cd） - 勾选
Emulate terminal in output console，否则nc和颜色日志会乱码
但注意：这个配置只能运行，不能调试。要调试 openim-api，得另建一个 Go Build 配置，且必须满足：
- Run kind =
Directory，Directory =$ProjectFileDir$/cmd/openim-api - Program arguments =
--port=10002 --env=dev - Environment variables 中补全
GOPROXY=https://www.php.cn/link/b6512ba2ef13d7241ba28dbf20bff5a7和LOG_LEVEL=debug - 确保该配置的 Working directory 和脚本中
cd cmd/openim-api一致，否则读不到./config
调试时别忽略 goroutine 和日志断点的协同使用
微服务间通过 HTTP/gRPC 通信，单步跟踪容易断在 client stub 或 transport 层。这时候光看调用栈没用，得结合上下文。
推荐组合策略：
- 在
openim-api的 handler 入口设普通断点，确认请求进来了 - 在它调用
openim-rpcclient 的地方设 日志断点（右键断点 → More → Log message to console），输出Calling GetUser: {userID}，不中断执行 - 切到
openim-rpc的对应 handler，设 条件断点：userID == "test123"，精准捕获目标请求 - 打开
Goroutines面板，观察是否有 goroutine 卡在context.DeadlineExceeded—— 这往往意味着上游超时或下游未响应，比查代码更快定位瓶颈
真正麻烦的从来不是“怎么启动”，而是“启动后哪条链路卡住了”。顺序只是表象，可观测性才是微服务调试的核心。别让脚本替你思考，让它替你守夜。
