asp.net-web-api - Swashbuckle + XmlComments 在本地工作，但在服务器上生成 swagger 失败

Question

我有一个 webapi 项目，我正在使用 swashbuckle 框架来刷新 api 文档。

我已按照说明使用我的 Controller 和 DTO 构建文档 xml 文件，并且在本地运行良好。

但是在生成swagger文档的时候，抛出了500错误。我已经确认，如果我删除了我的 xml 注册行，就会生成并成功返回 swagger 文档。

这是我的注册行:

GlobalConfiguration.Configuration.EnableSwagger(c =>
                    { 
...
    c.IncludeXmlComments($"{System.AppDomain.CurrentDomain.BaseDirectory}bin\\Company.MyApp.xml");
...

更新: 我做了一些额外的日志记录，虽然 IncludeXmlComments 的这个 lne 在启动时成功运行，当我从服务器请求 swagger.json 文件时，我收到了 System.IO.FileNotFoundException: Could not find file 'D:\home\site\wwwroot\bin\Monetary.Scheduling.xml' 异常。当我使用 Kudu 工具查看此目录时，找不到此文件。

TL;DR: 为什么这个文件在本地显示良好，但是当我使用 Kudu 或 Octopus nugget 包部署到 Azure 时，这个文件不存在？

Answer 1

问题是不知何故 XML 文件没有进入您的服务器......
我在 Azure 部署中遇到了这个确切的问题，它在我的本地机器上运行良好，但在 azure 中不

...这是因为我在发布配置中缺少 XML 文档