给自托管后端写个一键启动脚本：start_all 踩坑记

一、为什么需要一键脚本

客户机器上没有 Docker、没有 node 环境概念，你让他 go build + npm run 他根本不会。我的方案：把"启动顺序"固化成一个 Python 脚本，双击或一条命令就能跑。

二、脚本要兜住什么

1. 强杀残留进程：上次没正常退出，端口被占，新进程起不来；
2. 按依赖顺序起：先数据库/Redis，再后端，最后前端；
3. 捕获失败：某步起不来，别静默继续，要报错停在那一环。

三、核心逻辑（思路）

1. 扫描并 kill 占用 8080 / 5173 的残留进程
2. 启动后端二进制（后台），轮询 /health 直到 200
3. 启动前端 dev server（后台）
4. 打印访问地址

健康检查这一步很关键——直接 sleep 3 不够稳，网络慢时后端还没起完，前端连不上就报一堆错。

四、踩坑一：Windows 下杀进程权限

taskkill 在某些 Windows 版本要管理员权限。我一开始用 os.system("taskkill /F /PID ...")，客户普通账号跑就失败。改成先查进程是否存在再杀，且给出"请用管理员运行"的友好提示。

五、踩坑二：后台进程被 Python 退出带走

用 subprocess.Popen 起的后台进程，主脚本退出时如果没 detach，会被一起杀掉。Windows 上要 CREATE_NEW_PROCESS_GROUP，Linux 上要 start_new_session=True，否则"脚本跑完服务也没了"。

六、踩坑三：日志去哪

客户说"起不来"但啥也说不清。我把每个子进程的 stdout/stderr 重定向到 logs/xxx.log，并让脚本末尾打印"看 logs/backend.log"。这一条救了无数次远程支持。

七、交付清单

交付时附：

• start_all.py / stop_all.py；
• config.yaml.example（让他们填数据库连接）；
• 一句"默认账号 admin / admin123，上线前务必改"。

【总结】 一键脚本的本质是"把你的运维经验固化成代码"。它解决的不是技术难题，是"让不懂的人也能用"。健康检查、进程分离、日志落盘，这三点是这类脚本的命门。