.NET 5 Web API接口如何直接返回存储过程输出的JSON结果

核心思路是跳过常规的实体映射、JSON序列化流程，直接透传数据库返回的JSON字符串，避免不必要的性能损耗，具体实现分两层处理：

• 仓储层处理：执行存储过程时直接读取返回的标量字符串结果，不要做实体映射、反序列化操作。以EF Core为例代码如下：

public async Task<string> ExecuteSpReturnJsonAsync(int queryParam)
{
    var jsonResult = await _dbContext.Database
        .SqlQueryRaw<string>(
            "EXEC dbo.YourQuerySp @QueryParam", 
            new SqlParameter("@QueryParam", queryParam)
        )
        .FirstOrDefaultAsync();
    return jsonResult;
}

如果用Dapper实现，直接调用QueryFirstOrDefaultAsync<string>执行存储过程即可，逻辑一致。

• 控制器层处理：不要直接返回字符串类型结果，使用ContentResult指定响应内容类型为application/json，避免框架二次序列化。

[HttpGet("dynamic-report")]
public async Task<IActionResult> GetDynamicReportData()
{
    var jsonContent = await _reportRepository.ExecuteSpReturnJsonAsync(123);
    return Content(jsonContent, "application/json");
}

注意：如果直接返回string类型结果，ASP.NET Core默认序列化逻辑会给字符串包裹外层引号、对内部引号做转义，最终返回的不是合法的JSON结构。

这个方案没有绝对的对错，完全适配场景就是合理的：

• 适用的合理场景
  • 存储过程返回结果结构动态不固定，比如动态报表、自定义表单查询场景，返回列、字段类型随配置变化，无法提前定义固定实体类做映射
  • 大结果集聚合场景，数据库端使用原生JSON函数（比如SQL Server的FOR JSON PATH）生成JSON的性能远高于应用层拉取全量数据再做序列化
  • 历史存量系统兼容场景，现有存储过程逻辑已经过长期验证稳定，改造的成本和风险远高于透传收益
• 不建议使用的场景
  • 返回结果结构完全固定，直接透传JSON会丢失强类型校验，开发阶段无法做编译期检查，Swagger等接口文档工具也无法自动生成准确的返回结构说明，后续迭代容易出现字段名、类型错误
  • 存储过程通过字符串拼接手工生成JSON，没有做特殊字符转义，存在JSON格式非法、内容注入的风险

不需要第一时间要求DBA修改，根据实际场景判断即可：

• 无需修改的情况：符合上述合理场景，存储过程使用数据库原生JSON能力输出格式合法的结果，性能满足业务要求，应用层透传没有逻辑障碍，完全可以保留现有逻辑
• 建议协调DBA调整的情况：返回结构固定但存储过程用低效的字符串拼接生成JSON、错误率高；或者后续接口需要做统一响应包装、字段权限裁剪、数据脱敏等应用层逻辑，透传JSON无法支撑这类处理，此时可以让存储过程返回结构化的表数据，由应用层完成序列化和后续逻辑处理，长期维护性更好。

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