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