如何在Visual Studio用模拟工具本地调试.NET Core 3.0/3.1 Lambda？

我之前碰到过一模一样的情况——AWS Visual Studio工具还没支持.NET Core 3.1的时候，要调试基于SQS或S3的Lambda，亲测下面几个方法都好用：

方法一：用Amazon.Lambda.TestUtilities构造事件调试 #

这是最直接的方式，不需要额外工具，靠单元测试框架就能搞定：

• 新建一个**.NET Core 3.1单元测试项目**，安装NuGet包：Amazon.Lambda.TestUtilities、Amazon.Lambda.SQSEvents（如果是SQS触发器）、Amazon.Lambda.S3Events（如果是S3触发器）
• 在测试方法里手动构造事件对象，比如SQS事件：

  var sqsEvent = new SQSEvent
  {
      Records = new List<SQSEvent.SQSMessage>
      {
          new SQSEvent.SQSMessage
          {
              Body = "你的测试消息内容",
              MessageId = "test-message-id",
              ReceiptHandle = "test-receipt-handle"
          }
      }
  };
  

  要是S3事件，就构造S3Event，填好Bucket名称、对象Key、事件类型这些关键字段
• 实例化你的Lambda函数类，调用FunctionHandler方法，传入构造的事件和TestLambdaContext：

  var function = new Function();
  var context = new TestLambdaContext();
  await function.FunctionHandler(sqsEvent, context);
  

• 在测试方法里加断点，直接运行测试就能调试，TestLambdaContext还能帮你输出日志，方便排查问题

方法二：用AWS SAM CLI本地模拟运行 #

SAM CLI是AWS官方的本地模拟工具，和VS工具无关，支持.NET Core 3.1：

• 先安装AWS SAM CLI（这个是独立工具，和VS插件不冲突）
• 在Lambda项目根目录创建template.yaml，定义你的函数和触发器：

  AWSTemplateFormatVersion: '2010-09-09'
  Transform: AWS::Serverless-2016-10-31
  Resources:
      MySQSLambda:
          Type: AWS::Serverless::Function
          Properties:
              CodeUri: ./bin/Debug/netcoreapp3.1/publish/
              Handler: YourAssemblyName::YourNamespace.Function::FunctionHandler
              Runtime: dotnetcore3.1
              Events:
                  SQSTrigger:
                      Type: SQS
                      Properties:
                          Queue: !GetAtt MyQueue.Arn
      MyQueue:
          Type: AWS::SQS::Queue
  

• 编译Lambda项目：dotnet publish -c Debug
• 用SAM CLI构建：sam build
• 本地调用Lambda：如果是SQS，可以用sam local invoke MySQSLambda -e event.json（event.json是你提前写好的SQS事件JSON）；要是S3，能直接生成模拟事件：sam local generate-event s3 put --bucket my-test-bucket --key test-file.txt | sam local invoke MyS3Lambda
• 要调试的话，加--debug-port 5005参数：sam local invoke MySQSLambda -e event.json --debug-port 5005，然后在VS里选择“调试”→“附加到进程”，连接到本地5005端口的进程，就能断点调试了

方法三：把Lambda改成控制台程序临时调试 #

这个方法适合快速验证逻辑，不用额外项目：

• 修改Lambda项目的.csproj文件，把<OutputType>Library</OutputType>改成<OutputType>Exe</OutputType>，并添加<StartupObject>YourNamespace.Program</StartupObject>
• 新建Program.cs，在里面手动构造事件并调用Lambda函数：

  namespace YourNamespace
  {
      class Program
      {
          static async Task Main(string[] args)
          {
              var sqsEvent = new SQSEvent
              {
                  // 填充测试事件内容
              };
              var function = new Function();
              await function.FunctionHandler(sqsEvent, new TestLambdaContext());
          }
      }
  }
  

• 直接按F5运行控制台程序，就能断点调试了，调试完记得把.csproj改回原来的设置，不然部署会出错

注意事项 #

• 如果你的Lambda需要访问其他AWS服务（比如读取S3对象、发送SQS消息），要确保本地配置了AWS凭证（可以通过环境变量AWS_ACCESS_KEY_ID/AWS_SECRET_ACCESS_KEY，或者~/.aws/credentials文件）
• 构造事件的时候尽量贴近真实场景的字段，比如S3事件的eventName、s3.object.size这些，避免因为字段缺失导致逻辑异常
• SAM CLI的方式更贴近AWS真实运行环境，能模拟触发器的整个调用流程，适合复杂场景的调试

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