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

靓仔建2025-10-09 11:26

最近在搞个框架进行模块化的，在主程序加载程序集里的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;
  }

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