Serverless Offline本地运行Lambda Layer时UUID模块找不到的解决方案咨询

这个问题其实很常见——AWS Lambda线上环境会自动处理Layer的模块路径，但Serverless Offline本地运行时默认不会把Layer的node_modules加入Node.js的模块搜索路径，所以才会出现本地找不到uuid但线上正常的情况。下面给你几个靠谱的解决方法：

方法1：手动设置NODE_PATH环境变量 #

Node.js会根据NODE_PATH环境变量查找模块，我们可以把Layer的node_modules路径加到这个变量里，让本地环境能找到依赖。

方式A：在serverless.yaml中配置环境变量 #

修改你的serverless.yaml，在provider下添加环境变量配置：

service: aws-nodejs
provider:
  name: aws
  runtime: nodejs8.10
  stage: dev
  environment:
    # 把Layer的node_modules路径加到NODE_PATH，后面保留默认的运行时路径
    NODE_PATH: './nodejs/node_modules:/var/runtime/node_modules'
plugins:
  - serverless-offline
layers:
  layer1:
    path: nodejs
    name: ${self:provider.stage}-layerName
functions:
  hello:
    handler: handler.hello
    layers:
      - {Ref: Layer1LambdaLayer}
    events:
      - http:
          path: /dev
          method: get

方式B：启动时临时设置环境变量 #

如果你不想修改配置文件，可以在启动Serverless Offline时直接指定NODE_PATH：

NODE_PATH=./nodejs/node_modules serverless offline start

方法2：配置Serverless Offline自动识别Layer #

新版的serverless-offline插件已经支持本地模拟Lambda Layer了，你只需要在配置里指定Layer的目录即可，它会自动把Layer的模块路径加入搜索。

在serverless.yaml中添加custom配置：

custom:
  serverless-offline:
    # 指向你的Layer根目录，插件会自动识别里面的node_modules
    layersDir: ./nodejs

注意：确保你的serverless-offline版本足够新（建议v8.0以上），如果版本过低可能不支持这个功能，可以用npm update serverless-offline升级。

方法3：代码层面动态切换导入路径（不推荐，仅作备选） #

如果上面的方法都不适用，你可以在代码里根据环境判断，手动指定本地依赖的路径：

// handler.js
let uuid;
// 利用serverless-offline自动设置的IS_OFFLINE环境变量判断
if (process.env.IS_OFFLINE) {
  // 本地开发时直接从Layer的node_modules导入
  uuid = require('../nodejs/node_modules/uuid');
} else {
  // 线上环境正常导入即可
  uuid = require('uuid');
}

exports.hello = async (event) => {
  // 使用uuid
  const id = uuid.v4();
  return {
    statusCode: 200,
    body: JSON.stringify({ id }),
  };
};

这个方法需要修改业务代码，不够优雅，所以优先推荐前两种方法。

额外注意：确认Layer目录结构 #

最后要确保你的Layer目录结构是正确的：你的nodejs文件夹下应该直接包含node_modules，也就是nodejs/node_modules/uuid，这样不管是线上AWS还是本地配置后，都能正确找到依赖。

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