最近在搞个框架进行模块化的,在主程序加载程序集里的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;
}
希望我的经历能帮助大家。