ASP.NET Core Web API中Swagger仅显示带参接口，其余HttpGet/HttpPost方法不可见

核心触发点 #

Swagger漏展示接口的问题，主要由两个ASP.NET Core Web API开发中的常见配置疏漏导致：

• 控制器类未声明类级别的API路由约定
  你的UsersController直接继承了ControllerBase但没有添加类级别的路由标注，框架默认不会为纯API控制器套用Web API路由规则，会自动匹配传统MVC的路由模板，容易出现端点注册冲突，导致无参的GetUsers()方法无法被识别为有效API端点，自然不会被Swagger扫描展示。
• 控制器内Action方法重名引发元数据解析冲突
  同一个控制器下存在两个同名的GetUsers方法，仅靠HTTP谓词和路由模板做区分、没有显式指定唯一的Action名称时，Swagger扫描组件会因为接口元数据重复，自动过滤掉无参的方法重载，最终仅展示可以正常完成元数据解析的带参GET接口和POST接口。

修正实现方案 #

按照下面的代码调整控制器定义，即可解决接口不展示的问题：

// 补充类级别的路由与API控制器特性
[Route("api/[controller]")]
[ApiController]
public class UsersController : ControllerBase 
{
    private readonly IKullnicilar _userRepositories;
    public UsersController(IKullnicilar userRepositories) 
    {
        _userRepositories = userRepositories;
    }

    // 为无参GET接口指定唯一Action名称，解决重名冲突
    [HttpGet]
    [ActionName("GetAllUsers")]
    public async Task<IEnumerable<Users>> GetUsers() 
    {
        return await _userRepositories.Get();
    }

    // 为带参GET接口指定唯一Action名称
    [HttpGet("{id}")]
    [ActionName("GetUserById")]
    public async Task<ActionResult<Users>> GetUsers(int id) 
    {
        return await _userRepositories.Get(id);
    }

    [HttpPost]
    public async Task<ActionResult<Users>> PostUsers([FromBody] Users user)
    {
        var newUser = await _userRepositories.Create(user);
        // 同步修正CreatedAtAction的目标Action名称，避免路由生成异常
        return CreatedAtAction(nameof(GetUserById), new { id = newUser.id }, newUser);
    }
}

注意：调整完成后需要重新启动项目，Swagger会自动扫描所有注册成功的API端点，不会再出现漏展示的问题。

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