端口冲突时router.Run()报错为“listen tcp :8080: bind: address already in use”，需用lsof或netstat查PID并kill残留进程；正确写法是router.Run(":8080")或router.Run("127.0.0.1:8080")，生产环境应从环境变量读取端口。
直接换端口最省事，但得知道为什么换、怎么换、换完还可能卡在哪。
端口被占时 router.Run() 报错的具体表现
运行 go run . 后看到类似错误，说明端口冲突已发生：
listen tcp :8080: bind: address already in use
这不是 Gin 的 bug，而是操作系统拒绝重复绑定同一端口。常见来源包括：另一个 go run . 进程没关、宝塔面板里已运行的 Go 项目、Docker 容器、甚至 VS Code 的调试残留进程。
- 先用
lsof -i :8080（macOS/Linux）或netstat -ano | findstr :8080（Windows）查 PID - 确认不是自己刚启动的服务后，再 kill：macOS/Linux 用
kill -9 PID，Windows 用taskkill /PID PID /F - 别只看浏览器打不开就重装 Gin——90% 的“部署失败”其实压根没走到 Gin 启动那步
router.Run() 的端口写法必须带冒号
router.Run("8080") 会 panic，报错 missing port in address；正确写法只有两种：
-
router.Run(":8080")→ 绑定所有 IPv4 接口（等价于0.0.0.0:8080） -
router.Run("127.0.0.1:8080")→ 只监听本地回环，外部无法访问，适合开发调试
生产环境不建议硬编码端口。推荐从环境变量读取：
r.Run(":" + os.Getenv("PORT"))
这样在 systemd 或 Docker 中只需改 PORT=9090 就能切换，不用动代码。
宝塔面板和 systemd 下的端口管理要点
宝塔的「Go 项目管理器」默认把你的二进制文件当后台服务跑，但它不会自动帮你释放端口。如果之前部署失败过，很可能残留一个 ./app 进程还在占着 8080。
- 在宝塔【终端】里执行
ps aux | grep app，手动 kill 掉旧进程 - systemd 部署时，
ExecStart必须写绝对路径，比如/www/wwwroot/go.xxx.com/app，否则服务启动后找不到可执行文件，日志里只显示failed to start process - systemd 的
Restart=always会反复拉起崩溃的服务，但如果端口一直被占，它就会无限报bind: address already in use，看起来像服务起不来——其实是没清理干净
真正麻烦的不是换端口，而是换完之后忘了改反向代理配置（比如 Nginx 的 proxy_pass http://127.0.0.1:9090），或者没通知前端调用方新地址。端口只是入口，上下游对齐才是关键。
