AWS Lambda搭配API Gateway使用node-fetch报错:无法找到node-fetch模块
问题核心原因
AWS Lambda的Node.js执行环境仅预装Node.js官方内置模块、AWS SDK,不会自动加载代码中引用的第三方npm依赖。代码中require('node-fetch')引用的内容不属于Lambda内置范围,没有将对应依赖打包进函数部署包时,运行时会直接抛出模块缺失的报错。
解决路径
零依赖优化方案
Lambda当前提供的Node.js 18.x及以上版本运行时,已经原生内置全局fetch方法,无需安装任何第三方依赖:
- 直接删除代码第一行
const fetch = require('node-fetch') - 原有fetch调用逻辑无需修改,即可正常运行
注意:如果Lambda运行时版本低于Node.js 18,原生fetch能力未开放,需要走依赖打包方案。
旧版本运行时适配方案
如果必须使用Node.js 16及更早的运行时,需要把node-fetch和代码一起打包为部署包上传:
- 本地代码目录下执行
npm init -y初始化npm项目 - 安装适配版本的node-fetch:CommonJS写法需要安装
node-fetch@2.6.7,如果安装node-fetch@3.x版本,会因为ESM模块规范兼容问题,导致require调用直接报错 - 打包时校验目录结构:解压生成的zip包后,要直接看到入口函数js文件、node_modules目录,不要嵌套外层文件夹,否则Lambda会因路径错误找不到模块
- 将zip部署包上传到Lambda控制台替换原有代码即可
易踩的坑
- 代码里的接口地址存在换行空格,模板字符串拼接出的实际URL会携带无效空格,会导致接口请求格式错误,需要将endpoint字符串拼接为无换行的完整格式
- 模块问题解决后,如果Lambda运行在配置了公网访问限制的VPC内,需要配套配置NAT网关或放开公网访问权限,否则调用外部天气接口会超时失败
内容的提问来源于stack exchange,提问作者Chase
相关产品推荐
相关产品推荐

