npm cache verify npm cache clean --force rm -rf node_modules package-lock.json npm install
删掉 node_modules 重新装，启动还是报 Cannot find module，去目录里看那个包又确实存在。这类现象通常不是突然出现的，往前翻半天日志能看到苗头。
追下去是这么回事：本地缓存里存了损坏的包压缩文件，重装时直接解压缓存，坏文件被原样还原进 node_modules。
围绕「npm 缓存损坏」排查时，命令行跑一遍比在面板里点十次有用，面板会替你做掉不少隐式操作。监控和日志的时间要对上，时区不一致会多绕很大一圈。
临时改动用注释写上日期和原因，过两周自己都记不清为什么这么写。动手前把原文件复制一份带时间戳，出问题立刻换回去，比现场分析快得多。
一次只改一处，改完立刻验证，几个改动叠在一起，出问题就说不清是谁导致的。先做最小复现，能稳定跑出来的问题，排查成本会低一个数量级。
处理上按这个顺序：先清缓存并做一次完整性校验；用 ci 模式严格按锁文件安装；不行就连锁文件一起删掉重来。
确认没问题再收工，启动不再报模块找不到，npm ls 输出完整没有 missing。