ASP.NET Core API动态字段返回实现咨询（不使用GraphQL）

你希望通过查询参数让用户选择API返回的字段，且不想使用GraphQL，以下几个成熟的类库可以满足需求：

1. System.Linq.Dynamic.Core #

这是最贴合你示例需求的轻量库，直接支持动态构建LINQ查询的Select表达式，完美适配EF Core，最终会转换为只查询指定字段的SQL，性能优异。

使用示例： #

using System.Linq.Dynamic.Core;

public async Task<ActionResult<Result<object>>> GetData(
    [FromQuery] string[] fields,
    [FromService] IRepo repo)
{
    // 将字段数组转为动态Select需要的格式，例如"Id,UserName,Email"
    var selectClause = string.Join(",", fields);
    
    // 动态投影指定字段
    var data = await repo.Models
       .Select($"new ({selectClause})")
       .ToArrayAsync();

    return new Result<object> { Data = data };
}

关键特点： #

• 直接兼容EF Core，不会加载冗余数据
• 无需复杂映射配置，代码简洁
• 支持嵌套字段（例如User.Name）

2. AutoMapper #

如果你已经在项目中使用AutoMapper，可以利用它的动态投影功能，基于传入的字段列表构建映射配置，实现精准字段返回。

使用示例： #

using AutoMapper;

public async Task<ActionResult<Result<BaseModel>>> GetData(
    [FromQuery] string[] fields,
    [FromService] IRepo repo,
    [FromService] IMapper mapper)
{
    // 动态创建仅包含指定字段的映射配置
    var dynamicConfig = new MapperConfiguration(cfg =>
    {
        cfg.CreateMap<ModelType, BaseModel>()
           .ForAllMembers(opt => opt.Ignore()); // 先忽略所有字段
        
        foreach (var field in fields)
        {
            // 手动启用需要返回的字段
            cfg.CreateMap<ModelType, BaseModel>()
               .ForMember(field, opt => opt.MapFrom(src => src.GetType().GetProperty(field).GetValue(src)));
        }
    });

    var data = await repo.Models
       .ProjectTo<BaseModel>(dynamicConfig)
       .ToArrayAsync();

    return new Result<BaseModel> { Data = data };
}

关键特点： #

• 适合已有AutoMapper的项目，保持技术栈一致
• 支持复杂对象映射和字段转换
• 可结合Profile配置做基础映射，动态扩展

3. FastExpressionCompiler #

如果需要高度自定义动态投影逻辑，同时追求表达式编译性能，可以用这个库快速构建并编译表达式树，替代手动写复杂的反射代码。

使用示例： #

using FastExpressionCompiler;
using System.Linq.Expressions;

// 自定义动态投影构建方法
private static Expression<Func<ModelType, dynamic>> BuildDynamicProjection(string[] fields)
{
    var param = Expression.Parameter(typeof(ModelType), "model");
    var memberBindings = fields.Select(field =>
    {
        var property = Expression.Property(param, field);
        return Expression.Bind(typeof(ExpandoObject).GetProperty(field), property);
    });

    var initExpr = Expression.MemberInit(Expression.New(typeof(ExpandoObject)), memberBindings);
    return Expression.Lambda<Func<ModelType, dynamic>>(initExpr, param).CompileFast();
}

// 接口中使用
public async Task<ActionResult<Result<dynamic>>> GetData(
    [FromQuery] string[] fields,
    [FromService] IRepo repo)
{
    var projection = BuildDynamicProjection(fields);
    var data = await repo.Models
       .Select(projection)
       .ToArrayAsync();

    return new Result<dynamic> { Data = data };
}

关键特点： #

• 表达式编译速度比原生Expression.Compile快数倍
• 完全自定义投影逻辑，适合特殊业务场景
• 返回ExpandoObject可直接序列化为JSON

通用注意事项 #

• 字段校验：必须对传入的fields参数做合法性校验，确保字段存在于ModelType中，避免SQL注入或无效字段报错
• 序列化处理：返回动态类型（如ExpandoObject）时，ASP.NET Core会自动序列化为JSON；返回固定DTO时需确保映射配置正确

内容的提问来源于stack exchange，提问作者J.Common