TypeScript构建Lambda函数时，如何从Lambda Layer导入类型？

我之前也碰到过一模一样的糟心事——本地开发时TypeScript完全认不出/opt/nodejs/...这种AWS Lambda Layer的路径，导致类型提示全失效，只能靠// @ts-ignore硬混，太影响开发效率了。其实核心问题很简单：TypeScript编译器不知道生产环境的/opt/nodejs对应你本地电脑上的哪个文件夹，咱们只需要在TS配置里给它明确指个路就行，具体步骤如下：

1. 修改Lambda函数的tsconfig.json，添加路径映射 #

在你的Lambda函数项目的tsconfig.json中，找到compilerOptions节点，补充baseUrl和paths配置，把AWS运行时的Layer路径映射到你本地Layer源码的实际位置。

举个例子，假设你的项目结构是这样的：

your-project/
├── lambdas/
│   └── user-handler/  # 你的Lambda函数目录
│       ├── src/
│       └── tsconfig.json
└── layers/
    └── shared-types/      # 你的Layer目录
        └── src/
            └── index.ts   # 里面定义了SomeType

那你Lambda的tsconfig.json就可以这么写：

{
  "compilerOptions": {
    "baseUrl": ".",  // 基础路径，paths会基于这个路径查找文件
    "paths": {
      // 把AWS运行时的路径映射到本地Layer的源码路径
      "/opt/nodejs/myLayer": ["../../layers/shared-types/src"]
    },
    // 保留你原来的其他配置，比如target、module、outDir等
    "target": "ES2020",
    "module": "CommonJS",
    "outDir": "./dist"
  }
}

2. 验证类型导入是否正常 #

现在回到你的Lambda代码里，原来的导入语句：

import { SomeType } from '/opt/nodejs/myLayer';

TypeScript应该就能自动识别到本地Layer里的SomeType了，类型提示、编译检查都能正常工作，再也不用依赖// @ts-ignore来掩盖错误了。

为什么这个方法有效？ #

AWS Lambda运行时会把你的Layer代码挂载到/opt/nodejs目录下，但本地开发时这个路径根本不存在。通过paths配置，我们告诉TypeScript：“当你看到/opt/nodejs/myLayer这个导入路径时，去本地的../../layers/shared-types/src文件夹找对应的代码”。这样既符合生产环境的路径规范，又完美解决了本地开发的类型识别问题。

另外提一句，如果你用SAM CLI本地调试Lambda，SAM会自动处理Layer的挂载逻辑，本地运行时也能正常读取到Layer里的代码，和这个配置完全不冲突。

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