部署AWS CDK时遭遇Docker守护进程连接错误，如何排查解决？

核心原因 #

你遇到的错误根源是Docker守护进程未运行。AWS CDK的NodejsFunction默认会使用Docker容器构建Lambda函数的部署包（用于处理依赖编译、运行时环境匹配等场景），当前系统无法连接到Docker daemon，直接导致打包流程失败。

解决步骤 #

1. 启动Docker服务 #

根据操作系统执行对应操作：

• Mac/Windows：打开Docker Desktop，等待状态栏显示Docker服务正常运行（通常会显示鲸鱼图标）。
• Linux：在终端执行命令启动并设置开机自启：

  sudo systemctl start docker
  sudo systemctl enable docker
  

2. 验证Docker连接状态 #

在终端执行docker ps，如果能正常输出容器列表（空列表也属于正常状态），说明Docker daemon已启动且连接正常。

3. 可选：调整NodejsFunction构建配置（跳过Docker） #

若不想依赖Docker，可在NodejsFunction配置中强制关闭Docker打包，但需确保本地Node.js版本与Lambda运行时版本一致，且代码无需要编译的原生依赖：

export class AnalyticsReportService extends NodejsFunction {
  constructor(scope: Stack, id: string, props: NodejsFunctionProps) {
    super(scope, id, {
      ...props,
      bundling: {
        useDocker: false,
        nodeVersion: NodejsVersion.NODE_18_X // 替换为你使用的Lambda运行时版本
      }
    });
  }
}

补充说明 #

你的代码逻辑本身没有问题，AnalyticsReportService继承NodejsFunction后，CDK会自动处理Lambda的打包部署流程，但该流程依赖Docker保证构建环境与Lambda运行时的一致性。只要Docker服务正常运行，重新执行cdk deploy即可完成部署。

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