如何在MacOSX与Ubuntu间同步CDK项目，解决Lambda部署报错问题？

核心原因 #

CDK通过计算本地代码目录的哈希值判断是否需要重新构建推送Docker镜像到ECR资产仓库。MacOS与Ubuntu的文件系统差异（如文件权限、换行符）会导致同一代码目录算出的哈希值不同；Ubuntu清理本地镜像后，CDK无法找到本地镜像，且哈希值与ECR中已存在的镜像不匹配，从而触发镜像不存在的错误。

解决方案 #

1. 统一资产哈希计算规则 #

在CDK项目的cdk.json中添加配置，消除文件系统差异对哈希计算的影响：

{
  "context": {
    "@aws-cdk/aws-ecr-assets:dockerIgnoreSupport": true,
    "@aws-cdk/aws-ecr-assets:assetHashType": "SOURCE"
  }
}

• dockerIgnoreSupport：启用.dockerignore规则，避免无关文件干扰哈希计算
• assetHashType": "SOURCE"：仅基于文件内容计算哈希，忽略权限、修改时间等元数据差异

2. 强制Ubuntu端重新构建推送镜像 #

在Ubuntu电脑上执行命令，强制CDK重新构建并推送镜像到ECR：

cdk deploy --force --no-asset-reuse

• --force：跳过部署确认步骤
• --no-asset-reuse：强制重新构建所有资产，不依赖本地缓存或ECR已有镜像

3. 同步ECR镜像到Ubuntu本地（可选） #

若不想每次都重新构建，可直接从ECR拉取已有镜像到Ubuntu本地：

1. 登录ECR：

aws ecr get-login-password --region us-east-2 | docker login --username AWS --password-stdin account_id.dkr.ecr.us-east-2.amazonaws.com

2. 拉取对应镜像（替换XXXXXXXX为报错中的镜像标签）：

docker pull account_id.dkr.ecr.us-east-2.amazonaws.com/cdk-hnb659fds-container-assets-account_id-us-east-2:XXXXXXXX

4. 确保跨设备代码完全同步 #

用Git管理项目时，做好以下配置避免代码差异：

• 禁用换行符自动转换：

git config --global core.autocrlf false

• 提交.dockerignore文件，保证两台设备的忽略规则一致
• 不要将cdk.out等本地生成目录提交到Git，避免跨设备冲突

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