AWS CDK无服务器应用本地开发：cdk synth优化问题咨询

背景 #

使用AWS CDK开发中等规模无服务器应用，包含多类Python Lambda（ZIP包/镜像）、SQS、SNS等资源。本地调试依赖aws sam invoke或aws sam start-lambda，但每次代码变更都需执行cdk synth，存在效率问题，以下是对应问题的解决方案：

1. 能否避免每次代码变更执行cdk synth，实现ZIP包Lambda热重载？ #

可以通过SAM与CDK模板结合的方式实现，无需每次synth：

• 先执行一次cdk synth生成栈模板（位于cdk.out/YourStackName.template.json）；
• 手动修改模板中ZIP包Lambda的CodeUri字段，将原本指向cdk.out资产目录的路径替换为本地Lambda代码的实际路径（比如./src/lambda/my-function）；
• 启动本地Lambda端点时，使用命令：aws sam start-lambda --template ./cdk.out/YourStackName.template.json --warm-containers LAZY；
  修改代码后直接调用Lambda，SAM会自动加载最新代码，实现热重载。

2. 若必须执行cdk synth，能否仅更新变更资产，避免全量构建？ #

可以通过以下优化减少重复构建：

• 使用cdk synth --no-staging：跳过资产到cdk.out staging目录的复制，直接引用本地构建产物（仅适合本地调试，部署时需移除该参数）；
• 配置Lambda的BundlingOptions：设置keepOutputDirectory: true，CDK会复用之前的构建输出目录，不会每次删除重建；
• 拆分依赖安装与代码复制：在bundling命令中，仅当requirements.txt变更时重新安装依赖，否则仅复制代码。例如自定义bundling命令：

bash -c "if [ requirements.txt -nt /asset-output/requirements.txt ]; then pip install -r requirements.txt -t /asset-output; fi && cp -au . /asset-output"

• 定期清理旧资产：CDK会基于内容哈希生成新资产目录，旧目录可通过cdk clean或手动删除cdk.out中过时的资产文件夹，避免体积膨胀。

3. 如何配置CDK让ZIP包Python Lambda使用pip缓存，解决权限警告？ #

通过在Lambda的bundling配置中指定可写的pip缓存目录，解决权限问题并复用依赖缓存：
在CDK代码中为Lambda设置BundlingOptions，自定义命令创建缓存目录并配置环境变量：

from aws_cdk import aws_lambda as lambda_

lambda_.Function(self, "MyZipLambda",
    runtime=lambda_.Runtime.PYTHON_3_11,
    handler="handler.lambda_handler",
    code=lambda_.Code.from_asset("./src/lambda/my-function",
        bundling=lambda_.BundlingOptions(
            image=lambda_.Runtime.PYTHON_3_11.bundling_image,
            command=[
                "bash", "-c",
                "mkdir -p /tmp/pip-cache && chmod 777 /tmp/pip-cache && pip install --cache-dir /tmp/pip-cache -r requirements.txt -t /asset-output && cp -au . /asset-output"
            ],
            environment={"PIP_CACHE_DIR": "/tmp/pip-cache"}
        )
    )
)

该配置会创建可写的临时缓存目录，pip会复用已下载的依赖包，同时消除权限警告。

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