.NET API接口返回重复数组：如何优化FluentResults响应格式

你的问题是FluentResults的Result<T>默认序列化后会输出Value、ValueOrDefault、IsSuccess、IsFailed等字段，导致响应出现重复数据。以下是两种可行的解决方法：

方案一：自定义API结果类（推荐） #

完全自定义响应结构，摆脱FluentResults默认字段限制，更贴合API设计需求。

1. 定义自定义结果类型 #

public class ApiResult<T>
{
    public bool IsSuccess { get; init; }
    public T? Data { get; init; }
    public List<string> Errors { get; init; } = new();

    // 快速创建成功响应
    public static ApiResult<T> Ok(T data)
    {
        return new ApiResult<T> { IsSuccess = true, Data = data };
    }

    // 快速创建失败响应
    public static ApiResult<T> Fail(string error)
    {
        return Fail(new List<string> { error });
    }

    public static ApiResult<T> Fail(List<string> errors)
    {
        return new ApiResult<T> { IsSuccess = false, Errors = errors };
    }
}

2. 修改接口实现 #

[HttpGet("persons/{personId:guid}/profile/organizations/coordinates")]
public async Task<ApiResult<List<ProfileCoordinateViewModel>>> GetProfileCoordinates(Guid personId)
{
    try
    {
        var coordinates = await _profileCoordinateService.GetProfileCoordinates(personId);
        var result = coordinates.Select(ProfileCoordinateViewModel.FromDomainObj).ToList();
        return ApiResult<List<ProfileCoordinateViewModel>>.Ok(result);
    }
    catch (Exception ex)
    {
        return ApiResult<List<ProfileCoordinateViewModel>>.Fail($"Something went wrong: {ex}");
    }
}

修改后响应结构简洁明了：

• 成功响应：{"isSuccess":true,"data":[...],"errors":[]}
• 失败响应：{"isSuccess":false,"data":null,"errors":["错误详情"]}

方案二：配置序列化过滤（保留FluentResults） #

如果不想替换FluentResults，可以通过JSON序列化配置忽略冗余字段：

1. 忽略ValueOrDefault字段 #

在Program.cs中配置控制器的JSON序列化选项，针对Result<T>类型忽略ValueOrDefault属性：

builder.Services.AddControllers()
    .AddJsonOptions(options =>
    {
        options.JsonSerializerOptions.TypeInfoResolverModifier = typeInfo =>
        {
            if (typeInfo.Type.IsGenericType && typeInfo.Type.GetGenericTypeDefinition() == typeof(Result<>))
            {
                var valueOrDefaultProp = typeInfo.Properties.FirstOrDefault(p => p.Name.Equals("ValueOrDefault", StringComparison.OrdinalIgnoreCase));
                if (valueOrDefaultProp != null)
                {
                    valueOrDefaultProp.IsIgnored = true;
                }
                // 可选：忽略IsFailed，因为IsSuccess已经能表示状态
                var isFailedProp = typeInfo.Properties.FirstOrDefault(p => p.Name.Equals("IsFailed", StringComparison.OrdinalIgnoreCase));
                if (isFailedProp != null)
                {
                    isFailedProp.IsIgnored = true;
                }
            }
            return typeInfo;
        };
    });

2. （可选）自定义FluentResults输出结构 #

部分FluentResults版本支持通过配置自定义结果的输出字段：

FluentResults.Settings.Current.DefaultResultSettings.Setup(result =>
{
    result.WithCustomState(() => new 
    { 
        result.IsSuccess, 
        Data = result.Value, 
        result.Errors 
    });
});

这种方式会让FluentResults只序列化你指定的字段，但需要确认你的FluentResults版本是否支持该API。

总结 #

优先选择方案一，自定义结果类能完全控制响应结构，避免依赖第三方库的默认行为，也更符合API设计的简洁性要求。如果必须保留FluentResults的使用，再考虑方案二的序列化配置。

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