AWS API Gateway/Lambda C# 调用NYT图书API的ExpandoObject实现问题

一、「Failed to find method FunctionHandler」报错排查方向 #

• 入口方法访问级别不符合要求：当前参考代码中FunctionHandler未添加public修饰符，C#类成员默认访问级别为private，AWS Lambda .NET 运行时仅会扫描类中公开的入口方法，非公开方法无法被识别，是触发该报错的最直接原因。
• 方法签名不匹配默认约定：Lambda .NET 运行时对入口方法的签名有明确要求，需匹配Task<T 返回类型> FunctionHandler(T输入类型, ILambdaContext context)的格式，当前参考代码混用同步WebRequest与异步HttpClient逻辑，且存在未完成的异步等待逻辑，会导致签名匹配失败。
• Handler配置路径不匹配：Lambda控制台的函数处理器配置需要严格遵循程序集名称::命名空间.类名::入口方法名的格式，大小写、命名空间、类名与实际代码不一致时，会出现找不到方法的错误。
• 核心依赖引用缺失：未正确引入Amazon.Lambda.Core、Amazon.Lambda.Serialization.SystemTextJsonNuget包时，运行时无法正确识别ILambdaContext参数与序列化逻辑，也会触发入口方法探测失败。

二、外部API返回值正确转换为ExpandoObject的实现逻辑 #

当前参考代码直接将HttpWebResponse对象塞进ExpandoObject的属性，既无法读取到API返回的实际图书数据，Lambda序列化时也会因为网络流对象无法被正常序列化导致返回值异常，正确的实现步骤为：

• 统一使用静态复用的HttpClient实例发起请求，不要混用WebRequest与HttpClient两套请求逻辑，避免Lambda环境下的套接字耗尽、响应流未释放问题。
• 拿到API响应后先校验状态码，确认请求成功后将响应内容读取为纯JSON字符串，不要直接把带网络流的响应对象存入ExpandoObject。
• 将读取到的JSON字符串通过JSON序列化器反序列化为ExpandoObject，配置忽略大小写匹配属性，即可自动将纽约时报图书API返回的所有嵌套JSON结构映射为ExpandoObject的动态属性，无需手动定义强类型数据模型。
• 针对调用过程中的异常，也可以用ExpandoObject封装错误信息返回，统一返回格式。

修正后的可运行参考代码 #

using System;
using System.Dynamic;
using System.Net.Http;
using System.Threading.Tasks;
using Amazon.Lambda.Core;
using System.Text.Json;

// 配置Lambda默认JSON序列化器
[assembly: LambdaSerializer(typeof(Amazon.Lambda.Serialization.SystemTextJson.DefaultLambdaJsonSerializer))]

namespace newyorktimes
{
    public class Function
    {
        // 静态复用HttpClient，避免频繁创建实例造成资源浪费
        private static readonly HttpClient _httpClient = new HttpClient();

        // 入口方法标记为public static，匹配Lambda签名要求
        public static async Task<ExpandoObject> FunctionHandler(string input, ILambdaContext context)
        {
            try
            {
                var nytBookApiUrl = "https://api.nytimes.com/svc/books/v3/lists/current/hardcover-fiction.json?api-key=你的API密钥";
                
                // 异步发起GET请求
                var apiResponse = await _httpClient.GetAsync(nytBookApiUrl);
                // 校验响应是否成功
                apiResponse.EnsureSuccessStatusCode();
                
                // 读取API返回的JSON文本
                var responseJson = await apiResponse.Content.ReadAsStringAsync();
                
                // 直接将JSON反序列化为ExpandoObject，自动映射所有动态属性
                dynamic apiResult = JsonSerializer.Deserialize<ExpandoObject>(responseJson, new JsonSerializerOptions
                {
                    PropertyNameCaseInsensitive = true
                });

                // 动态封装最终返回结构
                dynamic finalResult = new ExpandoObject();
                finalResult.BookListData = apiResult;
                finalResult.QueryTimestamp = DateTime.UtcNow;

                return finalResult;
            }
            catch (Exception ex)
            {
                // 异常信息用ExpandoObject统一封装
                dynamic errorResult = new ExpandoObject();
                errorResult.ErrorInfo = ex.Message;
                context.Logger.LogError($"接口调用失败: {ex.StackTrace}");
                return errorResult;
            }
        }
    }
}

实现注意点 #

• 不要把HttpWebResponse、HttpResponseMessage这类持有网络连接、流的对象直接存入ExpandoObject返回，这类对象在Lambda序列化时会被截断，无法返回实际业务数据。
• ExpandoObject作为动态类型，可以灵活追加、删除属性，完全满足动态封装API返回结果的要求，不需要提前为纽约时报图书API的返回结构定义强类型模型。

内容的提问来源于stack exchange，提问作者S-Jay