Swagger UI空白PDF下载

Question

我在尝试下载 PDF 文件时遇到了 Swagger UI 问题。在 Swagger UI 之外一切正常（使用 curl 或 Postman 没有问题），但是当我尝试通过 Swagger UI 下载时，我得到一个空白 PDF。

我正在使用 Springfox 2.50（微服务 JHipster 应用程序），我的 Java Spring 方法的响应是 HttpEntity<byte[]>。

编辑： 我发现了类似的问题：Swagger UI Download PDF 但它没有任何答案。

Answer 1

您的设置可能存在以下问题之一：

1) 您服务器上的@produces（因此在 swagger 定义中）可能不正确。请确保您的操作中有produces: application/pdf。

2) 您返回 pdf 的操作可能没有与之关联的架构。要让 swagger-ui 呈现正确的下载，您需要有一个模式。正确的架构是：

schema:
  type: string
  format: byte

3) 您的服务器必须返回正确的Content-Type。请确保标题中是application/pdf

您可能想在您的服务器上尝试petstore sample，因为这是最新版本的 swagger-ui，与 SpringFox 捆绑的版本可能有点落后。