Drone CI 构建时找不到已确认存在的Node模块问题排查
核心故障原因拆解
1. 环境变量导致devDependencies未安装
- 两个流水线步骤都配置了
NODE_ENV: production,npm在production环境下执行安装时,默认会跳过devDependencies字段内的包 - 查看项目package.json,构建流程依赖的
gulp-postcss、gulp-responsive、gulp-minify等核心Gulp插件,全部归类在devDependencies下,并未写入dependencies - 本地运行正常是因为本地开发环境通常未设置production的NODE_ENV,npm会默认安装全部依赖;之前Travis流水线可跑通,是因为没有额外注入production环境变量,迁移到Drone时保留了配置习惯直接踩坑
- install步骤执行ls看到node_modules目录存在,不代表目录内包含全部依赖:该目录下仅安装了dependencies列的7个生产依赖,devDependencies内的构建插件完全没有被下载,自然会抛出模块找不到的错误
- 报错栈也可以佐证这一点:gulp-cli本身能正常启动(因为gulp在dependencies里),但执行到gulpfile.js里
require('gulp-postcss')的语句时直接触发MODULE_NOT_FOUND,和dev依赖未安装的现象完全吻合
2. 临时卷挂载路径完全错位
- 两个步骤内配置的临时卷挂载路径为
/node_modules,但npm默认将依赖安装在项目工作目录下的/drone/src/node_modules路径,而非容器根目录的/node_modules - 相当于临时卷被挂载到了一个完全没有程序读取的空路径上,install步骤安装的依赖完全没有被持久化,跨步骤的依赖共享从根上就不成立
3. 冗余的权限配置引入额外变量
- build步骤配置了
privileged: true,该参数是给需要访问宿主机硬件、内核资源的特殊场景使用的,普通Node前端构建完全不需要开启,反而可能因为容器权限层级变化,导致npm解析依赖路径时出现非预期异常
可直接落地的修复方案
- 移除所有步骤中配置的
NODE_ENV: production环境变量,或者在执行npm安装命令时显式添加--include=dev参数,强制安装devDependencies内的构建插件 - 把临时卷的挂载路径从
/node_modules修改为/drone/src/node_modules,保证install步骤安装的依赖能被后续build步骤正常读取 - 删除build步骤里不必要的
privileged: true配置,和install步骤保持一致的容器运行权限 - 在install步骤的验证命令中增加依赖存在性检查,比如执行
ls node_modules | grep gulp-postcss,确认核心构建插件真的被安装后再执行后续流程
修复后可直接使用的.drone.yml参考配置
--- kind: pipeline type: docker name: default clone: depth: 2 steps: - name: install image: node:14 volumes: - name: nodemod path: /drone/src/node_modules pull: if-not-exists commands: # 显式安装全量依赖,不受NODE_ENV变量影响 - npm i --include=dev - ls node_modules | grep gulp-postcss - ls - name: build image: node:14 volumes: - name: nodemod path: /drone/src/node_modules commands: - npm run build volumes: - name: nodemod temp: {}
补充验证注意点
- 修复后如果仍报模块缺失,可在build步骤最前面加一行
ls /drone/src/node_modules/gulp-postcss,确认依赖路径真实存在 - 不要为了适配CI临时把devDependencies里的构建插件挪到dependencies字段,这种调整会破坏本地开发的依赖分类逻辑,长期维护成本很高
- 检查项目根目录是否存在.npmrc文件,确认没有配置生产环境安装时跳过dev依赖的自定义规则
内容的提问来源于stack exchange,提问作者hoobydooby
相关产品推荐
相关产品推荐

