Asp.net core用Swashbuckle.AspNetCore库出现错误信息:No operations defined in spec!

最近在搞个框架进行模块化的,在主程序加载程序集里的Controllers,启动程序在浏览器访问http://localhost:5200/swagger/index.html页面的API出现错误信息:

No operations defined in spec!

1,后来新建一个项目进行一一排查

先浏览器调试请求的http://localhost:5200/swagger/Sys/swagger.json里面返回的jsond的paths没有数据。证明获取不了Controllers的数据。

对比一下代码里面SwaggerDoc方法里参数module.Name与 c.SwaggerEndpoint方法的{module.Name}一致;

cs 复制代码
  builder.Services.AddSwaggerGen(
    doc =>
    {
        // module.Name 
        doc.SwaggerDoc(module.Name, new OpenApiInfo
        {
            Title = $"{module.Name} API",
            Version = module.Version,
            Description = module.Description
        });
        
        doc.AddSecurityDefinition("Bearer", new OpenApiSecurityScheme
        {
            Type = SecuritySchemeType.ApiKey,
            In = ParameterLocation.Header,
            Name = "Authorization"
        });
        
        doc.AddSecurityRequirement("Bearer", new List<string>());
    });   
cs 复制代码
app.UseSwaggerUI(c =>
{
    foreach (var module in Shared.Extensions.ModuleExtensions.Modules)
    {
        if (module.IsApplicationPart)
        {
            c.SwaggerEndpoint($"/swagger/{module.Name}/swagger.json", $"{module.Name} API");
        }
    }

});

2,必须加载Controllers的数据,要不然也是获取不了Controllers的数据。

cs 复制代码
  /// <summary>
  /// 向Mvc添加模块中的控制器
  /// </summary>
  public static IMvcBuilder AddModuleControllers(this IMvcBuilder mvcBuilder, string contentRootPath)
  {

      Shared.Extensions.ModuleExtensions.Modules = Shared.Extensions.ModuleExtensions.GetModules();
      foreach (var module in Shared.Extensions.ModuleExtensions.Modules)
      {
          //根据Modules文件夹和模块ID加载模块程序集  
          var moduleFolder = new DirectoryInfo(Path.Combine(Shared.Extensions.ModuleExtensions.ContentRootPath, $@"Modules\{module.Id}\{module.Id}.dll"));
          if (File.Exists(moduleFolder.ToString()))
          {
              var assembly = Assembly.LoadFrom(moduleFolder.ToString());
              mvcBuilder.AddApplicationPart(assembly);
          }
      }

      return mvcBuilder;
  }

希望我的经历能帮助大家。

相关推荐
追逐时光者1 天前
一款使用 C# 编写专为 Windows 11 打造的文件资源管理器增强工具!
后端·.net
风象南1 天前
普通人用AI加持赚到的第一个100块
人工智能·后端
冰_河1 天前
QPS从300到3100:我靠一行代码让接口性能暴涨10倍,系统性能原地起飞!!
java·后端·性能优化
JavaGuide1 天前
7 道 RAG 基础概念知识点/面试题总结
前端·后端
桦说编程1 天前
从 ForkJoinPool 的 Compensate 看并发框架的线程补偿思想
java·后端·源码阅读
格砸1 天前
从入门到辞职|从ChatGPT到OpenClaw,跟上智能时代的进化
前端·人工智能·后端
蝎子莱莱爱打怪1 天前
GitLab CI/CD + Docker Registry + K8s 部署完整实战指南
后端·docker·kubernetes
哈密瓜的眉毛美1 天前
零基础学Java|第三篇:DOS 命令、转义字符、注释与代码规范
后端
用户60572374873081 天前
AI 编码助手的规范驱动开发 - OpenSpec 初探
前端·后端·程序员