在 Micronaut 中设置 Swagger 配置答案

【问题标题】：Setup Swagger Configuration in Micronaut在 Micronaut 中设置 Swagger 配置
【发布时间】：2021-05-19 10:24:24
【问题描述】：

我有一个现有的 micronaut 应用程序，不是我编写的，它已经有一个 swagger 配置，但无法正常工作，我正在尝试了解原因。

首先看文档： OpenAPI/Swagger Support

它说 yaml 文件将生成到 META-INF/swagger ...但是我在项目中找不到该文件夹。

（定义了swagger依赖）

在项目（资源）yaml文件中有一个配置：

application:
  api:
    swagger:
      path: /openapi-doc/swagger
      version: 3.22.2
      urls:
        - name: student
          url: /openapi-doc/swagger/student-api.yml
        - name: course
          url: /openapi-doc/swagger/course-api.yml

这意味着项目中应该有文件夹 /openapi-doc/ ？还是会自动生成？因为我找不到该名称下的文件夹

或者我需要在根项目中创建文件夹？

所以不会在META-INF/swagger文件夹下生成

【问题讨论】：

当您构建应用程序时，会在build/classes/java/main/META-INF/swagger 下生成任何内容吗？
我在上一条评论中提到的路径与 Gradle 有关。如果您使用的是 Maven，同样的问题也适用于 target/classes/META-INF/swagger。
很难说你的项目出了什么问题，但一个好的起点可能是在 micronaut.io/launch 创建一个具有 openapi 功能的应用程序，看看是否为你正确生成了文档在那个项目中。
啊，是的，我在 maven swagger.yml 中找到了它。但是它只有一行“openapi: 3.0.1 是的，你的建议是个好主意，谢谢

标签： swagger micronaut

【解决方案1】：

也就是说项目中应该有/openapi-doc/文件夹？

没有。我不认为这引用了项目文件夹。我认为这引用了一个 URI。

还是自动生成？

如果构建配置正确，文档应该会自动生成。

或者我需要在根项目中创建文件夹？

我认为您不需要在项目的根目录中创建任何内容。

【讨论】：