本地调试Lambda函数导入Layer失败，路径配置问题求助

问题本质 #

你在tsconfig.json中配置的paths仅作用于TypeScript编译阶段，Node.js运行时（包括ts-node）不会读取该配置，因此运行时无法识别/opt/nodejs/match-puller-layer这个路径，导致出现MODULE_NOT_FOUND错误。而直接使用相对路径时，Node.js可以直接解析到文件，所以能正常运行。

解决方案 #

1. 用tsconfig-paths让运行时识别路径映射

tsconfig-paths可以让Node.js运行时读取tsconfig.json中的paths配置，实现编译和运行时的路径统一：

• 安装依赖：

  npm install --save-dev tsconfig-paths
  

• 修改Lambda函数目录下package.json的启动脚本，在ts-node命令前添加-r tsconfig-paths/register，示例：

  {
    "scripts": {
      "start": "ts-node -r tsconfig-paths/register index.ts"
    }
  }
  

  之后用npm start启动函数，ts-node会自动将/opt/nodejs/*映射到你配置的../../lambda-layers/*路径。

2. 对齐本地与部署时的Layer结构（可选，更贴近生产环境）

Lambda部署时，Node.js层的代码需要放在nodejs目录下（解压后对应/opt/nodejs），本地可以模拟这个结构：

• 修改Layer目录的tsconfig.json，将outDir改为dist/nodejs：

  {
    "compilerOptions": {
      "outDir": "dist/nodejs",
      // 其他配置保持不变
    }
  }
  

• 重新编译Layer代码，确保产物输出到match-puller-layer/dist/nodejs
• 修改Lambda的tsconfig.json中的paths，指向Layer的编译产物：

  {
    "paths": {
      "/opt/nodejs/*": [
        "../../lambda-layers/*/dist/nodejs"
      ]
    }
  }
  

  这样既符合生产环境的Layer结构，也能让编译和运行时的路径完全匹配。

3. 用Serverless/SAM本地工具简化配置（推荐）

如果使用Serverless Framework或AWS SAM开发，这些工具会自动处理Lambda Layer的本地挂载，无需手动配置paths和tsconfig-paths：

• Serverless Framework：安装serverless-offline插件，在serverless.yml中配置Layer引用，启动时会自动将Layer代码挂载到本地模拟的/opt/nodejs目录
• AWS SAM：使用sam local invoke命令，SAM会自动构建并挂载Layer，本地运行环境与生产完全一致

验证步骤 #

1. 执行npm run build编译Layer和Lambda代码（如果有build脚本）
2. 用修改后的启动命令运行Lambda函数
3. 确认导入语句import { MatchPullerClass } from "/opt/nodejs/match-puller-layer"不再报错

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