端口占用会把你连到别人的服务

更新于 2026-08-03

**「我起的服务没报错，但行为不对」时，先确认那个端口上监听的到底是不是你起的进程。** 端口被另一个项目的同类服务占用时，启动脚本可能照样成功（或你根本没注意），而请求全部打到了别人的服务上 —— 症状与「自己代码有 bug」完全一样。

实例形态

你以为：3102 = 我刚启动的 Agent
实际：  3102 = 另一个 worktree 的 Next Web
结果：  上传失败（错误来自另一个应用），排查方向被带偏

关键在于：这个错误不会指向端口冲突。上层把错误统一收口后，只显示「上传失败」，看起来像业务逻辑问题。

动作

  • 启动后不要只确认「没报错」，要确认这个端口上是哪个进程 / 哪个应用。
  • 端口被占时换一个空闲端口启动，并同步改掉所有指向它的下游配置（前后端地址要一起改）。
  • 多 worktree 并行开发时，给每个 worktree 固定一组端口，避免每次靠运气。

相关