.NET Core 7 Web API接口返回JSON带方括号问题求助

你遇到的核心问题是：单个EmployeeInfo对象被序列化为JSON数组返回，但Swagger调用正常。这说明问题大概率出在不必要的手动序列化操作或路由/序列化配置冲突上。

1. 移除冗余的JsonConvert序列化反序列化操作 #

你的代码里手动将Employee序列化再反序列化为EmployeeInfo完全多余，不仅降低性能，还可能引入不可预期的序列化行为。直接手动映射属性即可：

修改后的方法代码：

[HttpGet("{id},{password}")]
public async Task<ActionResult<EmployeeInfo>> LoginEmployee(string id, string password)
{
    if (_context.Employees == null)
    {
        return NotFound();
    }
    var employee = await _context.Employees.FindAsync(id);

    if (employee == null)
    {
        return NotFound();
    }

    if (!employee.Password.Equals(password))
    {
        return NoContent();
    }

    try
    {
        // 直接手动映射属性，替换原有的序列化反序列化逻辑
        var employeeInfo = new EmployeeInfo
        {
            EmployeeId = employee.EmployeeId,
            FirstName = employee.FirstName,
            LastName = employee.LastName,
            CompanyName = employee.CompanyName,
            FWarehouseId = employee.FWarehouseId
        };

        return employeeInfo;
    }
    catch (Exception)
    {
        return StatusCode(StatusCodes.Status500InternalServerError);
    }
}

2. 检查路由是否存在冲突 #

确认控制器中没有其他路由模板相似的GET方法，避免Postman请求匹配到错误的方法：

• 不要存在[HttpGet]或[HttpGet("{id}")]这类可能与[HttpGet("{id},{password}")]模糊匹配的路由
• 确保Postman请求的URL严格匹配当前方法的路由格式：https://你的API地址/控制器名/用户ID,密码

3. 检查全局JSON序列化配置 #

检查Program.cs中的JSON序列化配置是否异常：

• 如果使用默认的System.Text.Json，确认没有配置将单个对象包装为数组的逻辑：

builder.Services.AddControllers()
    .AddJsonOptions(options =>
    {
        // 确保无强制包装数组的异常配置
    });

• 如果使用Newtonsoft.Json，确认序列化配置正常，避免循环引用导致的异常结构：

builder.Services.AddControllers()
    .AddNewtonsoftJson(options =>
    {
        options.SerializerSettings.ReferenceLoopHandling = ReferenceLoopHandling.Ignore;
    });

4. 验证Postman请求参数与方法匹配 #

• 确认Postman使用GET请求方法
• 确认URL中的参数用逗号正确分隔（如ddavidson,123456），不要用?id=xx&password=xx的查询参数格式（你的路由是从URL路径取参数，不是查询参数）

Swagger会自动根据方法返回类型生成正确请求示例，且严格匹配路由模板，不会触发路由冲突或序列化异常情况。

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