如何通过Watch模式高效进行AWS Lambda（Python）本地测试？

Absolutely feel your pain—having to run cdk synth every single time before testing your Python Lambda with SAM is such a drag, especially when synth takes forever. The good news is there are a few ways to set up a watch-style workflow that lets you test changes instantly, no repeated synth required. Here are your best options, tailored to different use cases:

If you're only modifying your Lambda's Python code (no infrastructure tweaks like new permissions or environment variables), you can skip cdk synth entirely by using a minimal SAM template that points directly to your source code.

• First, create a local-test-template.yml in your project root:

AWSTemplateFormatVersion: '2010-09-09'
Transform: AWS::Serverless-2016-10-31
Resources:
  YourLambdaFunction:
    Type: AWS::Serverless::Function
    Properties:
      Runtime: python3.12 # Match your Lambda's runtime version
      Handler: app.lambda_handler # Update to your actual handler path (e.g., src/main.lambda_handler)
      CodeUri: ./path/to/your/lambda/code # Point directly to your Lambda's source folder

• Run SAM with the --watch flag to auto-reload on code changes:

sam local invoke YourLambdaFunction -t local-test-template.yml -e events/<event_name>.json --watch

Now any edits to your Python code will trigger an automatic re-invoke immediately—no cdk synth needed until you need to test infrastructure changes.

If you're tweaking both your Lambda code and CDK stack (like adding a layer, updating IAM policies, or changing environment variables), you can pair cdk watch with a file watcher to auto-trigger SAM invokes when the CDK template updates.

• Install a simple file watcher (we'll use nodemon here, but you can use Python's watchdog if you prefer):

npm install -g nodemon

• In one terminal, run cdk watch—it will automatically re-synth your stack whenever it detects changes to your CDK code or Lambda source:

cdk watch

• In a second terminal, use nodemon to watch the generated CDK template and run SAM invoke whenever it updates:

nodemon --watch cdk.out/api.template.json --exec "sam local invoke <lambda_name> -t cdk.out/api.template.json -e events/<event_name>.json"

Now both code and infrastructure changes will trigger a fresh SAM test run automatically.

If you use VS Code, the AWS Toolkit extension gives you a seamless watch-style workflow with built-in debugging support:

• Install the AWS Toolkit extension for VS Code
• Link your CDK project to the extension
• Create a debug configuration for your Lambda (the extension will auto-generate this for you)
• Launch the debug session with watch mode enabled—you can set breakpoints, edit code, and see changes take effect instantly without any manual CLI commands

This is the most integrated option, especially if you want to debug your Lambda code line-by-line while testing changes.

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