Serverless打包丢失依赖引发Runtime.ImportModuleError问题咨询

可能的原因及对应排查步骤 #

1. 依赖嵌套层级导致打包遗漏 #

Serverless默认打包项目根目录的node_modules，但如果graphql因版本冲突被安装在某个子依赖的node_modules目录中（而非顶层），其依赖的iterall会嵌套在该子目录下。部分场景下，Serverless的打包逻辑未完整遍历所有嵌套的node_modules，导致iterall被遗漏。

• 排查：本地执行find node_modules -name "iterall"，查看安装路径。若路径为node_modules/graphql/node_modules/iterall，说明存在版本冲突；再检查package-lock.json或yarn.lock，搜索iterall确认依赖链和版本冲突情况。

2. 依赖锁定文件不一致 #

本地node_modules可能基于旧锁定文件安装，后续修改package.json后未更新锁定文件，导致sls package时依赖安装不完整。比如graphql版本更新后，iterall的依赖关系未被正确写入锁定文件，打包时未被包含。

• 排查：删除package-lock.json/yarn.lock和node_modules，重新执行npm install或yarn install，再运行sls package检查打包文件是否包含iterall。

3. 隐性优化插件误删依赖 #

若项目安装了serverless-plugin-optimize、serverless-webpack等插件，即使未显式配置，部分插件默认启用树摇或压缩，可能误判iterall为未引用依赖而移除。

• 排查：查看package.json的devDependencies，确认是否存在这类插件，临时移除后重新打包测试；若用webpack，检查webpack.config.js的mode设置，临时改为development（关闭默认树摇）验证问题是否解决。

4. Serverless版本兼容性问题 #

不同版本的Serverless Framework对node_modules的打包逻辑存在差异，旧版本（如v2.x及以下）可能存在嵌套依赖打包不全的bug。

• 排查：执行sls --version查看当前版本，若版本较旧，升级到最新稳定版（v3.x）后重新打包测试。

内容的提问来源于stack exchange，提问作者gokublack