如何用 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中是否误加了
<publishtrimmed>true</publishtrimmed>：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<string string> { ["Content-Type"] = "application/json" }</string>，否则 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 —— 这种细节不会报错，但会悄悄拖慢所有请求。 
