无main文件时用NestJS运行AWS Serverless报错排查

你的核心问题是common模块被错误配置为应用类型了。NestJS的monorepo里，纯工具/模型模块应该是library类型，而非application——应用类型必须要有main.ts作为入口，这就是为什么无论是nest start还是构建后SAM启动都会找不到main模块的原因。

1. 修正nest-cli.json配置 #

打开nest-cli.json，把common模块的类型从application改成library，并且移除它的entryFile配置（库不需要入口文件）。示例配置如下：

{
  "$schema": "https://json.schemastore.org/nest-cli",
  "collection": "@nestjs/schematics",
  "monorepo": true,
  "root": "apps/users",
  "compilerOptions": {
    "tsConfigPath": "apps/users/tsconfig.app.json",
    "webpack": true,
    "deleteOutDir": true
  },
  "projects": {
    "users": {
      "type": "application",
      "root": "apps/users",
      "entryFile": "main",
      "sourceRoot": "apps/users/src",
      "compilerOptions": {
        "tsConfigPath": "apps/users/tsconfig.app.json"
      }
    },
    "common": {
      "type": "library",
      "root": "libs/common",
      "sourceRoot": "libs/common/src",
      "compilerOptions": {
        "tsConfigPath": "libs/common/tsconfig.lib.json"
      }
    }
  }
}

2. 调整构建与启动命令 #

• 本地启动时，只启动users应用：nest start users，不要直接用nest start（它会尝试启动所有应用模块，包括错误配置的common）
• 构建时，只构建users模块：nest build users，或者在Makefile里把构建命令改成针对users的，比如：

build-users:
  nest build users

3. 验证模块引用与依赖配置 #

• 确保users模块里引用common的路径是正确的，比如用monorepo的scope别名（比如@your-project/common），而不是相对路径
• 检查common模块的package.json，确保main字段指向正确的输出文件（比如dist/index.js），这样users模块才能正确导入公共代码
• 确认根目录的package.json里workspaces配置包含了common模块，比如：

"workspaces": [
  "apps/*",
  "libs/*"
]

4. Serverless/SAM适配调整 #

• 构建完成后，users模块的产物会在dist/apps/users目录下，SAM的Lambda handler要指向正确的路径，比如如果用了@nestjs/platform-lambda，handler应该是dist/apps/users/main.handler
• 确保Docker镜像构建时，只复制dist/apps/users目录到镜像里，或者完整复制dist但Lambda配置指向正确的入口

额外排查点 #

• 清理旧的dist目录后重新构建，避免缓存导致的问题
• 运行nest build users --watch测试本地构建是否正常，再启动服务验证
• 检查common模块的tsconfig.lib.json，确保compilerOptions里的outDir配置正确，输出到dist/libs/common

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