ASP.NET Web API中Swagger返回500错误：自定义SQL查询问题排查

核心问题原因 #

1. 路由冲突 #

两个接口都使用[HttpGet]但未指定唯一路由模板，ASP.NET Core无法区分这两个GET请求，请求时会触发路由匹配异常，这是500错误的诱因之一。

2. EF Core实体映射不匹配 #

第二个接口的自定义SQL仅查询Name字段，但_fullStackDbContext.Transactions对应的是完整的Transactions实体（包含Id、Amount等其他属性）。EF Core尝试将仅含Name的查询结果映射到完整实体时，会因缺少必填属性值抛出异常，这是500错误的核心原因。

解决步骤 #

1. 修复路由冲突 #

给每个GET接口添加唯一路由模板，确保请求能正确匹配：

[HttpGet("all")]
public async Task<IActionResult> GetAllTransaction()
{
    var transaction = await _fullStackDbContext.Transactions.ToListAsync();
    return Ok(transaction);
}

[HttpGet("names")]
public async Task<IActionResult> GetTotalItem()
{
    // 后续修改后的查询代码
}

调用时分别使用/api/[控制器名]/all和/api/[控制器名]/names即可区分。

2. 修正自定义SQL查询 #

针对仅查询Name的场景，推荐两种正确实现方式：

方式一：直接返回字符串列表（EF Core 7+）

用Database.SqlQuery直接接收单字段结果，无需映射到实体：

[HttpGet("names")]
public async Task<IActionResult> GetTotalItem()
{
    var transactionNames = await _fullStackDbContext.Database
        .SqlQuery<string>("SELECT Name FROM Transactions")
        .ToListAsync();
    return Ok(transactionNames);
}

方式二：使用DTO接收结果（适合扩展字段）

定义专用DTO类来匹配查询结果：

// 定义DTO
public class TransactionNameDto
{
    public string Name { get; set; }
}

// 接口代码
[HttpGet("names")]
public async Task<IActionResult> GetTotalItem()
{
    var transactionNames = await _fullStackDbContext.Database
        .SqlQuery<TransactionNameDto>("SELECT Name FROM Transactions")
        .ToListAsync();
    return Ok(transactionNames);
}

不推荐的方式（仅作参考）

如果必须映射到Transactions实体，需确保SQL返回实体所有必填字段：

[HttpGet("names")]
public async Task<IActionResult> GetTotalItem()
{
    var transactions = await _fullStackDbContext.Transactions
        .FromSqlRaw("SELECT Id, Name, Amount /* 列出所有实体必填字段 */ FROM Transactions")
        .ToListAsync();
    return Ok(transactions);
}

此方式维护成本高，实体结构变更时需同步修改SQL，不建议使用。

3. 查看详细错误日志 #

开发环境下，修改appsettings.json开启详细错误信息，方便定位问题：

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning",
      "Microsoft.EntityFrameworkCore": "Information"
    }
  },
  "DetailedErrors": true
}

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