C# AWS Lambda函数编写方法 C#如何创建和部署.NET Lambda

使用 AWS Toolkit for visual studio 创建 .NET Lambda 项目最快上手，安装插件后新建 AWS Lambda Project (.NET Core) 模板，自动配置运行时契约与依赖；注意 functionHandler 签名需匹配触发器类型，本地调试报“Could not load file or assembly”多因依赖未打包或裁剪启用；部署时须通过 aws-lambda-tools-defaults.json 或 CLI 显式设内存、超时及环境变量；API gateway 下返回 http 状态码需正确设置 Headers 和 IsBase64Encoded；冷启动性能受部署包体积与依赖深度直接影响。

如何用 AWS Toolkit for Visual Studio 创建 .NET Lambda 项目

Visual Studio 插件是最快上手方式，它自动生成符合 Lambda 运行时契约的模板，避免手动配置出错。

• 安装 AWS Toolkit for Visual Studio（支持 VS 2019/2022），重启后新建项目 → 选择 AWS Lambda Project (.NET Core)
• 模板默认使用 amazon.Lambda.Core 和 Amazon.Lambda.Serialization.SystemTextjson，无需额外引用基础包
• 生成的 Function.cs 中，FunctionHandler 方法签名必须匹配触发器输入输出类型，例如 API Gateway REST API 默认传入 APIGatewayproxyRequest，返回 APIGatewayProxyResponse
• 若选 “Empty Function” 模板，FunctionHandler 签名是 String FunctionHandler(string input, ILambdaContext context)，适合简单测试，但不适用于结构化事件（如 S3、DynamoDB stream）

为什么本地调试时总报 “Could not load file or assembly”

这是 .NET Lambda 最常见运行时错误，根本原因是部署包未包含所有依赖项或版本冲突。

• dotnet lambda deploy-function 命令会自动执行 dotnet publish -r linux-x64 --self-contained false，但若项目引用了非纯托管库（如 sqlite、ImageSharp 的 native binding），必须设为 --self-contained true 或显式指定 -r linux-x64
• 检查 .csproj 中是否误加了 true：Lambda 运行时不支持裁剪（trimming），启用会导致 System.Text.Json 等核心组件缺失
• 第三方 NuGet 包（如 AWSSDK.S3）建议固定小版本号（如 3.7.300.5），避免因 SDK 自动升级引入不兼容的 System.Net.Http 行为

部署时如何控制函数内存、超时和环境变量

这些参数不能只靠 Visual Studio ui 设置，必须通过部署命令或 aws-lambda-tools-defaults.json 显式声明，否则回退到默认值（128MB / 3s）。

• 在项目根目录添加 aws-lambda-tools-defaults.json，写入：

  {   "profile": "default",   "region": "us-east-1",   "function-name": "MyApiFunction",   "function-runtime": "dotnet6",   "function-memory-size": 512,   "function-timeout": 30,   "environment-variables": { "ASPNETCORE_ENVIRONMENT": "Production", "CONNECTION_STRING": "..." } }

• 若用 CLI 部署，等价命令是：dotnet lambda deploy-function --function-memory-size 512 --function-timeout 30 --environment-variables "{"ASPNETCORE_ENVIRONMENT":"Production"}"
• 注意：环境变量值若含空格或特殊字符，必须 JSON 转义；Lambda 控制台里显示的明文值是解码后的，但代码中 Environment.GetEnvironmentVariable("KEY") 拿到的是原始字符串

API Gateway 集成下如何正确返回 HTTP 状态码

直接 return new APIGatewayProxyResponse { StatusCode = 400 } 不保证前端收到对应状态码——关键在 IsBase64Encoded 和 Headers 是否合规。

• 必须设置 Headers = new Dictionary { ["Content-Type"] = "application/json" }，否则 API Gateway 可能将响应体当作二进制处理，导致前端解析失败
• 若返回非 JSON 内容（如 csv），需同时设 IsBase64Encoded = false 并显式指定 Headers["Content-Type"] = "text/csv"
• 不要依赖 context.Logger.LogLine() 输出作为调试依据：日志异步刷盘，函数已返回时日志可能尚未上传；应改用 context.Logger.LogInformation("status: {StatusCode}", statusCode) 并在 CloudWatch Logs 中按 requestId 过滤

Lambda 的冷启动延迟和运行时行为高度依赖发布包结构与依赖树深度。哪怕只多引用一个没用到的 NuGet 包，也可能让部署包体积翻倍、初始化时间增加 200ms —— 这种细节不会报错，但会悄悄拖慢所有请求。