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 小时前
17-2.【Linux系统编程】线程同步详解 - 条件变量的理解及应用
linux·c++·人工智能·后端
南山乐只2 小时前
【Spring AI 开发指南】ChatClient 基础、原理与实战案例
人工智能·后端·spring ai
努力的小雨3 小时前
从“Agent 元年”到 AI IDE 元年——2025 我与 Vibe Coding 的那些事儿
后端·程序员
源码获取_wx:Fegn08953 小时前
基于springboot + vue小区人脸识别门禁系统
java·开发语言·vue.js·spring boot·后端·spring
wuxuanok4 小时前
Go——Swagger API文档访问500
开发语言·后端·golang
用户21411832636024 小时前
白嫖Google Antigravity!Claude Opus 4.5免费用,告别token焦虑
后端
爬山算法5 小时前
Hibernate(15)Hibernate中如何定义一个实体的主键?
java·后端·hibernate
酩酊仙人5 小时前
ABP将ExtraProperties作为查询条件
数据库·postgresql·asp.net
用户26851612107566 小时前
常见的 Git 分支命名策略和实践
后端