ASP.NET Core API返回格式规范的无类型JSON的最佳实现方法

安全阿岳

2026-6-29

解决方案

方法一：使用Newtonsoft.Json的JToken（推荐，兼容性好）

1. 修改响应类

将ConversionResponse中的string类型字段替换为JToken（来自Newtonsoft.Json.Linq命名空间），它可以兼容任意JSON结构（对象、数组等）：

using Newtonsoft.Json.Linq;

public class ConversionResponse
{
    public JToken Json { get; set; }
}

2. 调整控制器逻辑

将获取到的JSON字符串解析为JToken，再赋值给响应对象：

[HttpGet()]
public async Task<IActionResult> ConvertFile(ConversionRequest request)
{
    string json = await GetJsonAsync(request);
    // 解析字符串为JToken，自动适配数组/对象结构
    var parsedJson = JToken.Parse(json);
    return Ok(new ConversionResponse{ Json = parsedJson });
}

方法二：使用System.Text.Json的JsonElement（原生无依赖）

如果项目使用原生System.Text.Json而非Newtonsoft.Json，可改用JsonElement：

1. 修改响应类

using System.Text.Json;

public class ConversionResponse
{
    public JsonElement Json { get; set; }
}

2. 调整控制器逻辑

解析JSON字符串为JsonDocument后，克隆根元素避免文档释放问题：

[HttpGet()]
public async Task<IActionResult> ConvertFile(ConversionRequest request)
{
    string json = await GetJsonAsync(request);
    using var jsonDoc = JsonDocument.Parse(json);
    // 克隆根元素，防止JsonDocument被释放后无法访问
    var jsonElement = jsonDoc.RootElement.Clone();
    return Ok(new ConversionResponse{ Json = jsonElement });
}