页面打不开,终端写的是 address already in use。我一开始把活动监视器里所有像服务的进程都停了,结果把正在用的数据库图形工具也关掉了。
后来只查 3000。命令是 lsof -nP -iTCP:3000 -sTCP:LISTEN。输出里能看到 pid 和完整命令行,能认出是不是自己上次没退出的进程。
认出来之后才 kill。如果命令是系统服务,就改项目的端口,不杀。我们本地约定应用用 3000,被占了就改 3001,并在启动日志里写明实际端口。
为了避免再开两份,启动脚本先做这个检查。被占用就打印 pid 和命令,然后退出,而不是直接失败一长串堆栈。
机器重启后还遇到过一次。会话恢复把旧进程拉了起来。脚本不区分是谁留下的,只看端口,所以这种情况也能挡住。
现在这台机器上 3000 只有一份。同事用同一份启动脚本,也不会再误停别人的进程。
本地能跑和别人能跑是两件事。我现在固定留三样:启动时实际读到的配置名、当前连的库名、监听的端口。这三样打在日志开头,不打密钥和连接串。提交前看差异,示例配置和真实配置分开,锁文件跟清单一起走。干净目录克隆后再装一次,比在自己机器上反复点运行更可信。
给后来的人看,所以写能照着做的步骤,不写感受。每一步写期望看到什么。看不到,就停在这一步,不要继续往下猜。步骤结束以后,用干净环境再做一次。自己的机器上能过,只能说明自己的机器上能过。
复查「本地起服务时端口被占了」时按这四步,不靠感觉。用改之前的同一组输入再走一遍,结果要变成预期的那样。在日志里打出实际读到的配置名、端口或库名,确认不是另一个还没关的进程。换一个干净环境再做一次。最后把现象、改动、确认方法写成三行放进仓库。
补充记录。本地构建我现在把它当成一份可以交接的步骤,而不是个人习惯。第一步,在干净目录克隆,不在自己改了一半的目录里证明‘能跑’。第二步,只看三行启动日志:配置名、库名、端口。对不上就停,不继续点页面。第三步,依赖以锁文件为准。清单写着能装,锁文件才决定装到哪一版。第四步,提交前看差异,配置里的地址、密钥、本机路径不要出现。示例文件用明显的假值。第五步,让另一个人按说明走一遍,走不通就改说明,不改口头解释。这五步做完,构建才算从‘我的机器’变成‘这个仓库’。漏掉干净目录或锁文件,问题会在别人那里才出现,而且看起来像环境玄学。
操作顺序。1. 在临时目录克隆一份干净代码,不在日常目录里验证。2. 按说明安装,锁文件和清单必须同时存在。3. 启动后只看三行日志:配置名、库名、端口。任一为空或对不上,就停。4. 用一条最小请求打通,再跑测试。5. 提交前看差异,确认没有地址、密钥、本机路径。6. 换一个同事的机器或一个新目录再走一遍。走不通就改说明,不增加口头步骤。做完把失败过的那一次也留下,只留成功,别人会在同一个地方再摔一次。