使用 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 最常见运行时错误，根本原因是部署包未包含所有依赖项或版本冲突。

Amazon Review Analyzer

使用 Reveyes API 批量抓取亚马逊商品评论，支持 20 个站点。 输出完整评论数据（含所有字段），并由 AI 从跨境电商运营者视角深度分析差评， 提供产品质量、物流包装、Listing 准确性、客服反馈、改善优先级等结构化分析报告。 Use when: 用户提到抓评论、查差评、分析竞品口碑、给出 ASI...

下载

• 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" }，否则 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 —— 这种细节不会报错，但会悄悄拖慢所有请求。