为什么添加 ApiExplorer 会破坏 Swashbuckle？

Question

我添加后

        services.AddVersionedApiExplorer();

以前正常工作的 Swashbuckle 开始显示空白的 Swagger json，带有默认版本，其中没有端点。

Answer 1

ApiExplorer 似乎需要在 API 控制器中存在 ApiControllerAttribute。因此，如果您没有使用此属性装饰您的控制器，那么当您添加 ApiExplorer 时，一切都会完美运行，之后 Swachbuckle 的行为就像您的项目中根本没有控制器一样（显然，这就是 ApiExplorer 所说的它）。

使用[ApiController] 装饰您的控制器可解决此问题。 如果您不想费心编写 RegExp 来为您应用这些更改，甚至不想进入每个控制器文件手动粘贴，[assembly:ApiController] 将一次性处理所有这些。