NodeJS Lambda with Layers：如何阻止TypeScript构建包含本地示例层

你当前的问题是本地测试用的示例层目录被TypeScript编译打包进产物，导致部署Lambda后无法加载真实的Layer。以下是几种可行的解决办法：

方法1：通过tsconfig排除示例层目录 #

直接在tsconfig.json里添加exclude字段，把本地的layers目录排除在编译范围外，同时保留paths映射保证本地测试正常。

修改后的tsconfig.json示例：

{
  "compilerOptions": {
    "paths": {
      "/opt/nodejs/*": ["./layers/*"]
    },
    // 其他编译选项...
  },
  "exclude": ["./layers/**/*"]
}

这样TypeScript编译时会完全忽略layers目录下的文件，不会把它们打包到构建产物里，但本地开发时paths映射依然生效，能正常引用示例层代码做测试。

方法2：用类型声明文件替代示例层实现 #

如果本地测试只需要类型检查而非实际运行逻辑，可以删掉示例层的JS文件，换成对应的类型声明文件（.d.ts），这样既满足TS的类型校验，又不会有多余代码被打包。

1. 在layers目录下创建myLayer.d.ts：

export default function doSomething(a: number, b: number): number;

2. 保持tsconfig.json的paths映射不变，同时可以把layers目录加入exclude或者让TS自动识别声明文件即可。

这种方式更符合TypeScript的类型规范，也避免了打包冗余代码。

方法3：通过构建工具排除外部依赖 #

如果你用Webpack、esbuild这类构建工具替代纯tsc编译，可以把/opt/nodejs/*标记为外部依赖，让构建工具不打包这些模块。

比如用esbuild的话，构建命令可以加--external:/opt/nodejs/*：

esbuild src/app.ts --bundle --platform=node --external:/opt/nodejs/* --outfile=dist/app.js

或者在esbuild配置文件里设置：

require('esbuild').build({
  entryPoints: ['src/app.ts'],
  bundle: true,
  platform: 'node',
  external: ['/opt/nodejs/*'],
  outfile: 'dist/app.js',
}).catch(() => process.exit(1))

这样构建工具会跳过对/opt/nodejs/myLayer的打包，部署后Lambda会自动加载真实Layer里的模块。

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