打開 swagger UI 會得到 404 with Micronaut

Question

按照此處的文檔 - https://micronaut-projects.github.io/micronaut-openapi/1.3.4/guide/index.ZFC35FDC70D5FC69D269883A822C7A53E

我將build.gradle配置為包含 swagger yaml 生成的編譯時任務，如下所示 -

tasks.withType(JavaCompile){
    options.encoding = "UTF-8"
    options.compilerArgs.add('-parameters')
    options.fork = true
    options.forkOptions.jvmArgs << '-Dmicronaut.openapi.views.spec=rapidoc.enabled=true,swagger-ui.enabled=true,swagger-ui.theme=flattop'
}

這就是我的application.yaml的樣子——

micronaut:
  server:
    port: 9090
    cors:
      enabled: true
  router:
    static-resources:
      swagger:
        paths: classpath:META-INF/swagger
        mapping: /swagger/**
      redoc:
        paths: classpath:META-INF/swagger/views/redoc
        mapping: /redoc/**
      rapidoc:
        paths: classpath:META-INF/swagger/views/rapidoc
        mapping: /rapidoc/**
      swagger-ui:
        paths: classpath:META-INF/swagger/views/swagger-ui
        mapping: /swagger-ui/**

就像文檔說的那樣，我還用Application.java進行了注釋，如下所示-

package com.api.backend;

import io.micronaut.runtime.Micronaut;
import io.swagger.v3.oas.annotations.OpenAPIDefinition;
import io.swagger.v3.oas.annotations.info.Contact;
import io.swagger.v3.oas.annotations.info.Info;

@OpenAPIDefinition(
    info = @Info(
            title = "API Backend",
            version = "0.0",
            description = "API backend"
    )
)
public class Application {

    public static void main(String[] args) {
        Micronaut.run(Application.class);
    }
}

After doing all this, when I try to open http://localhost:9090/swagger/api-backend-0.0.yaml it opens the generated open API spec yaml. 但是，如果我嘗試打開http://localhost:9090/swagger-ui/ ，我會得到404 。

誰能幫我找出問題或提出替代方案？

Answer 1

您可以添加以下代碼並檢查嗎，因為所有文件都在swagger-ui中

  router:
    static-resources:
      default:
        enabled: true
        mapping: /**
        paths: classpath:swagger
      swagger:
        paths: classpath:META-INF/swagger
        mapping: /swagger/**
      swagger-ui:
        paths: classpath:META-INF/swagger/views/swagger-ui
        mapping: /swagger-ui/**

Answer 2

所有步驟對我來說都是正確的。

您能否在構建項目后檢查是否在您的工件中的 META-INF/swagger/views/swagger-ui 下創建了 index.html 文件。

從 maven 的角度來看，我們在運行 mvn compile 后在 target 文件夾下看到這個：target/classes/META_INF/swagger/views/swagger-ui

Answer 3

配置看起來不錯，swagger-ui 應該在瀏覽器中可用http://localhost:8080/swagger-ui