key: ${{ runner.os }}-node-${{ hashFiles('**/package-lock.json') }}
- run: npm ci
- run: node -e "console.log(require('dayjs/package.json').version)"
package.json 加了 dayjs，流水线一路绿灯，运行时报 Cannot find module 'dayjs'。日志里 cache restored 命中，install 步骤跑了 2 秒就结束。这类现象通常不是突然出现的，往前翻半天日志能看到苗头。
追下去是这么回事：缓存 key 只按分支或者固定字符串算，lock 文件变了也命中旧缓存。恢复出来的 node_modules 里没有新依赖，npm 认为已是最新，直接跳过安装。
「CI 缓存失效」改完先别急着全量，挑一台机器放半天，真有问题这段时间就能看出来。同类问题如果隔一段时间又出现，多半是某个定时任务或重启流程把改动冲掉了。
把这次用到的命令存进笔记，比记住结论有用，换个环境还能照着走。改完隔一天再看一次，当场正常不代表能稳住。
处理上按这个顺序：把 lock 文件哈希加进缓存 key；恢复缓存后强制 npm ci 而不是 npm install；手动删一次远端缓存 排除旧产物干扰；缓存分层 node_modules 和 npm 缓存分开存；在流水线里打印关键依赖版本核对。
确认没问题再收工，改 lock 后缓存 key 变化 新依赖出现在构建日志的版本输出里。