泛型WebAPI端点实现与调用疑问：方法合理性及MVC调用方案

用户定义的API端点代码 #

[HttpPost("getdynamictypedbytasync")]
[ProducesResponseType(StatusCodes.Status405MethodNotAllowed)]
public async Task<IActionResult> GetDynamicTypedByTAsync<T>([FromBody] object[] datas) where T : class
{
    try
    {
        var data = await UowLookups.DynamicRepository().GetAllAsyncByT<T>();
        return Ok(data);
    }
    catch (Exception e)
    {
    }
}

技术问题 #

• 该端点的实现方法是否合理？
• 如何在ASP.NET MVC应用中调用此API并传递参数？

用户尝试的调用代码（执行报错） #

Type type = typeof(T);
var property = type.GetProperties();

using (var response = await _httpGatewayClient.PostAsJsonAsync(apiEndpoint, type, _options))

问题1：端点实现是否合理？ #

这个实现存在多处不合理：

1. 泛型端点路由失效：ASP.NET Core路由系统无法自动解析泛型参数<T>，不同泛型类型的请求会匹配到同一个端点，导致逻辑混乱。
2. HTTP方法不符合REST规范：该端点是获取数据的操作，却使用HttpPost，按照REST设计，查询/获取数据应使用HttpGet。
3. 冗余参数：[FromBody] object[] datas参数在方法内未被使用，属于无效定义。
4. 异常处理缺失：catch块为空，既不记录日志也不返回错误响应，会导致问题无法排查，违反异常处理最佳实践。

问题2：如何正确调用（含端点修复方案） #

由于泛型端点的天然限制，需先修改API设计，将类型信息作为请求参数传递，而非依赖泛型参数。以下是可行方案：

修复后的API端点（推荐Get方式）

[HttpGet("getdynamictyped")]
[ProducesResponseType(StatusCodes.Status200OK)]
[ProducesResponseType(StatusCodes.Status400BadRequest)]
[ProducesResponseType(StatusCodes.Status500InternalServerError)]
public async Task<IActionResult> GetDynamicTypedAsync([FromQuery] string typeFullName)
{
    try
    {
        // 根据类型全称获取Type对象
        Type entityType = Type.GetType(typeFullName);
        if (entityType == null)
        {
            return BadRequest("无效的类型名称");
        }

        // 反射调用泛型方法
        var repository = UowLookups.DynamicRepository();
        var method = repository.GetType().GetMethod("GetAllAsyncByT")?.MakeGenericMethod(entityType);
        if (method == null)
        {
            return BadRequest("未找到对应的泛型方法");
        }

        var data = await (Task<object>)method.Invoke(repository, null);
        return Ok(data);
    }
    catch (Exception ex)
    {
        // 此处添加日志记录逻辑，例如：_logger.LogError(ex, "获取动态类型数据失败")
        return StatusCode(StatusCodes.Status500InternalServerError, $"获取数据失败：{ex.Message}");
    }
}

MVC应用中的调用代码

// 目标类型的完整名称（格式："命名空间.类型名, 程序集名"）
string targetTypeFullName = "YourApp.Models.User, YourApp";
string apiEndpoint = $"api/YourController/getdynamictyped?typeFullName={Uri.EscapeDataString(targetTypeFullName)}";

using (var response = await _httpGatewayClient.GetAsync(apiEndpoint, _options))
{
    response.EnsureSuccessStatusCode();
    var data = await response.Content.ReadFromJsonAsync<object>();
    // 处理返回的数据
}

如果坚持使用Post方法传递类型信息（不推荐用于获取操作），可修改端点为：

[HttpPost("getdynamictyped")]
public async Task<IActionResult> GetDynamicTypedAsync([FromBody] string typeFullName)
{
    // 内部逻辑与Get版本一致
}

对应的调用代码：

string targetTypeFullName = "YourNamespace.YourEntityType, YourAssemblyName";
using (var response = await _httpGatewayClient.PostAsJsonAsync(apiEndpoint, targetTypeFullName, _options))
{
    response.EnsureSuccessStatusCode();
    var data = await response.Content.ReadFromJsonAsync<object>();
}

内容的提问来源于stack exchange，提问作者Jacob