Iris框架端口被占用错误源于端口已被占用或未正确调用app.Run()。需先用netstat/lsof确认占用情况，再通过修改端口、终止进程或清理残留实例解决，并注意Run()的阻塞特性。
Iris框架启动时报“端口被占用”错误，说明当前监听的端口（如:8080）已被其他进程独占，服务无法绑定成功，浏览器访问会直接显示连接被拒绝或超时。
确认端口是否真被占用
在终端执行 netstat -ano | findstr :8080（Windows）或 lsof -i :8080（macOS/Linux），查看是否有 PID 占用该端口。若无输出，说明端口空闲，问题可能出在 Iris 启动逻辑本身——比如漏写 app.Run() 或误用 Listen() 但未实际触发监听。
这一步必须做，否则你可能在改防火墙或重启 IDE，而真实原因是代码根本没跑起来。
快速切换可用端口
直接修改 Run() 或 Listen() 中的地址参数，例如从 ":8080" 换成 ":8081" 或 ":3000"：
app.Run(iris.Addr(":8081"))
app.Listen(":3000")
这是最安全、最快见效的方式，无需杀进程、不干扰其他服务，适合开发调试阶段临时避让。
强制终止占用端口的进程
方法一：根据上一步查到的 PID，执行 taskkill /PID 12345 /F（Windows）或 kill -9 12345（macOS/Linux）。注意：杀错 PID 可能导致系统组件异常，务必核对进程名（可通过 tasklist | findstr 12345 或 ps -p 12345 -o comm= 补充验证）。
方法二：一键释放常用开发端口（8080/8000/3000/3001），Windows 用户可保存为 killports.bat：
@echo off
for %%p in (8080 8000 3000 3001) do (
for /f "tokens=5" %%i in ('netstat -ano ^| findstr :%%p') do taskkill /f /pid %%i 2>nul
)
运行后重新 go run main.go 即可。此脚本不校验进程用途，慎用于生产环境。
避免重复启动残留进程
第一步：检查是否多次执行 go run main.go 导致旧进程仍在后台运行。Windows 任务管理器 → 详细信息 → 查找多个 main.exe；macOS/Linux 执行 ps aux | grep main。
第二步：Go 编译生成的可执行文件（如 ./myapp）若手动双击运行，关闭终端不会自动退出进程，需手动 kill。开发时建议始终用 go run 启动，它会在 Ctrl+C 时自动终止子进程。
第三步：IDE（如 Goland/VS Code）热重载或调试模式可能未彻底清理旧实例。关闭调试会话后，执行 go clean -cache -modcache 清理构建缓存，再重启 IDE。
【关键提醒】 Iris 的 app.Run() 是阻塞式调用，一旦启动就不会返回。如果你在 Run() 后还写了其他代码（比如日志打印），它们永远不会执行——这不是端口问题，但常被误判为“启动失败”。
