Swashbuckle.AspNetCore.Swagger问题：API与数据库查询结果不一致求助

我开发了一个基于本地数据库的货币转换API，已完成Controller、Service、Repository三层搭建。直接查询数据库能拿到正确结果，但通过API调用却返回不了对应数据，折腾了好几个小时还是没解决，相关截图显示API调用未返回预期内容。

在Stack Overflow上找了两个类似问题：一个是Swagger无限加载，另一个是Swagger JSON无颜色，都和我的情况不匹配。

我的控制器代码如下：

[ApiController]
[Route("api/[Controller]")]
public class CurrencyController : ControllerBase
{
    [HttpGet]
    [Route("{code}")]
    public ObjectResult GetByCode([FromServices] CurrencyReadRepository repository, string code)
    {
        return Ok(repository.GetCurrency(code));
    }
    // 其他代码...
}

可能的问题点及解决步骤 #

1. 依赖注入方式问题

ASP.NET Core中推荐使用构造函数注入而非参数注入，[FromServices]参数注入可能存在服务未正确绑定的情况。改成构造函数注入试试：

private readonly CurrencyReadRepository _repository;

// 构造函数注入仓储
public CurrencyController(CurrencyReadRepository repository)
{
    _repository = repository;
}

// 合并路由写法，简化定义
[HttpGet("{code}")]
public ObjectResult GetByCode(string code)
{
    return Ok(_repository.GetCurrency(code));
}

2. 服务未正确注册

确保CurrencyReadRepository已在项目的服务配置中注册（比如Program.cs/Startup.cs）：

// 根据实际生命周期选择AddScoped/AddTransient/AddSingleton
builder.Services.AddScoped<CurrencyReadRepository>();

3. 对象序列化异常

GetCurrency返回的实体对象可能存在循环引用、未标记可序列化属性，或者包含延迟加载的导航属性，导致JSON序列化失败。可以在控制器里先手动序列化测试：

[HttpGet("{code}")]
public ObjectResult GetByCode(string code)
{
    var currency = _repository.GetCurrency(code);
    try
    {
        // 测试序列化是否正常
        var json = System.Text.Json.JsonSerializer.Serialize(currency);
        return Ok(currency);
    }
    catch (Exception ex)
    {
        // 返回序列化错误信息
        return BadRequest($"序列化失败：{ex.Message}");
    }
}

如果是循环引用问题，可以在Program.cs中配置JSON序列化选项：

builder.Services.AddControllers()
    .AddJsonOptions(options =>
    {
        options.JsonSerializerOptions.ReferenceHandler = System.Text.Json.Serialization.ReferenceHandler.IgnoreCycles;
    });

4. 异常被静默吞掉

仓储方法内部可能抛出异常但未被捕获，导致API返回500错误但Swagger未显示详细信息。添加日志或try-catch排查：

private readonly CurrencyReadRepository _repository;
private readonly ILogger<CurrencyController> _logger;

public CurrencyController(CurrencyReadRepository repository, ILogger<CurrencyController> logger)
{
    _repository = repository;
    _logger = logger;
}

[HttpGet("{code}")]
public ObjectResult GetByCode(string code)
{
    try
    {
        _logger.LogInformation("处理货币查询请求，编码：{Code}", code);
        var currency = _repository.GetCurrency(code);
        _logger.LogInformation("查询结果：{Currency}", currency?.ToString() ?? "空");
        return Ok(currency);
    }
    catch (Exception ex)
    {
        _logger.LogError(ex, "查询货币编码{Code}时出错", code);
        return StatusCode(500, $"服务器内部错误：{ex.Message}");
    }
}

5. 请求路由或参数问题

检查请求URL是否正确：控制器路由是api/[Controller]，所以完整请求路径应为api/Currency/XXX（XXX是货币编码）。另外确认参数code的大小写是否和数据库中一致，比如数据库存的是大写USD，请求传小写usd可能导致查询不到。

6. 跳过Swagger直接测试

不用Swagger，用Postman、curl等工具直接发送HTTP请求，查看返回的状态码和响应内容，能更直观看到错误信息：

curl http://localhost:5000/api/Currency/USD

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