Swagger UI端点与登台时的dev不同(不包括域名)
IIS配置
public void Configure(IApplicationBuilder app,IHostingEnvironment env,ILoggerFactory loggerFactory)
app.UseSwagger(c=>
{
//Change the path of the end point,should also update UI middle ware for this change
c.RouteTemplate = "api-docs/{documentName}/swagger.json";
});
app.UseSwaggerUI(c =>
{
//Include virtual directory if site is configured so
c.SwaggerEndpoint(Configuration["Appsettings:VirtualDirectory"]+"api-docs/v1/swagger.json","Api v1");
});
services.AddSwaggerGen(c =>
{
var xmlDocPath = Path.Combine(PlatformServices.Default.Application.ApplicationBasePath,"Api.xml");
c.IncludeXmlComments(xmlDocPath);
c.DescribeAllEnumsAsStrings();
具有上述配置
发展
"AppSettings": {
"VirtualDirectory": "/"
}
分期
"AppSettings": {
"VirtualDirectory": "/Api/"
}
启动计算机上UI的终点,暂存时间为ON
http://localhost:5001/api-docs/v1/swagger.json
但是在登台服务器上也是一样的
http://xxxx:5002/swagger/Api/api-docs/v1/swagger.json
而不是(应该是什么)
http://xxxx:5002/Api/api-docs/v1/swagger.json
解决方法
这个问题与环境变量更相关. Swagger支持虚拟目录,然后配置应如下所示.请注意,虚拟目录不会影响UI端点.
app.UseSwagger(c =>
{
//Change the path of the end point,should also update UI middle ware for this change
c.RouteTemplate = "api-docs/{documentName}/swagger.json";
});
app.UseSwaggerUI(c =>
{
//Include virtual directory if site is configured so
c.RoutePrefix = "api-docs";
c.SwaggerEndpoint("v1/swagger.json","Api v1");
});
