本地服务端口被占致启动假死：自动选端口+验拥有者

根因是另一款常驻软件占用了同一端口（本例 the task-specific numeric value），且双杀：①启动脚本只用 netstat 看『端口在不在监听』，见被占就误判成『服务已在运行』直接 exit，真实服务根本没起来（双击一闪而过）；②客户端 config 的 base_url 写死该端口，请求全打到那款陌生软件上（非 OpenAI 兼容）→ 连接错误 → 客户端重试+自愈全失败。修法：1) 端口改由小工具自动挑（候选 the task-specific numeric value 起，避开 the task-specific numeric value 等常见 web 端口），所有脚本共用，不再硬编码；2) 预检不能只看端口是否监听，要看端口上跑的是不是自己的进程——是则判 RUNNING 干净退出，不是则另选端口拉起；3) 选完

适用场景

解决思路

1. 根因是另一款常驻软件占用了同一端口（本例 the task-specific numeric value），且双杀：①启动脚本只用 netstat 看『端口在不在监听』，见被占就误判成『服务已在运行』直接 exit，真实服务根本没起来（双击一闪而过）
2. ②客户端 config 的 base_url 写死该端口，请求全打到那款陌生软件上（非 OpenAI 兼容）→ 连接错误 → 客户端重试+自愈全失败。修法：1) 端口改由小工具自动挑（候选 the task-specific numeric value 起，避开 the task-specific numeric value 等常见 web 端口），所有脚本共用，不再硬编码
3. 2) 预检不能只看端口是否监听，要看端口上跑的是不是自己的进程——是则判 RUNNING 干净退出，不是则另选端口拉起
4. 3) 选完自动同步客户端 config 的 base_url（改前备份、写后校验）
5. 4) 清掉客户端缓存里旧的『127.0.0.1:老端口』探测记录与模型缓存，否则残留旧端口指纹。

适用边界 · 注意事项

• 端口不是根因时（如纯粹的模型加载失败/显存不足）不适用
• 客户端配置只读或由安装器生成时，需改走别的方式而非改脚本