{"id":5225,"date":"2021-06-16T18:34:10","date_gmt":"2021-06-16T10:34:10","guid":{"rendered":"https:\/\/www.xttblog.com\/?p=5225"},"modified":"2021-06-16T18:35:20","modified_gmt":"2021-06-16T10:35:20","slug":"webflux%e6%95%b4%e5%90%88swagger%e6%95%99%e7%a8%8b","status":"publish","type":"post","link":"https:\/\/www.xttblog.com\/?p=5225","title":{"rendered":"webflux\u6574\u5408swagger\u6559\u7a0b"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">\u76f8\u4fe1\u5df2\u7ecf\u6709\u4e0d\u5c11\u4eba\u4e0a\u624b\u4e86 webflux\uff0c\u5305\u62ec\u6211\u4e4b\u524d\u4e5f\u5199\u4e86\u5f88\u591a\u7c7b\u4f3c\u7684\u6574\u5408\u6559\u7a0b\uff0c\u4f46\u662f\u5728\u6574\u5408 swagger \u6846\u67b6\u65b9\u9762\uff0c\u6211\u8fd8\u662f\u7b2c\u4e00\u6b21\u5c1d\u8bd5\u3002<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">webflux \u548c springmvc \u4e0d\u540c\uff0cwebflux \u8fd4\u56de\u7684 Mono\u3001Flux \u4e0d\u80fd\u88ab swagger \u6846\u67b6\u6b63\u5e38\u8bc6\u522b\u3002\u56e0\u6b64\u6211\u4eec\u8981\u5f15\u5165 springfox-spring-webflux\uff0c\u5426\u5219\u7684\u8bdd\u9700\u8981\u5199\u5f88\u591a\u7684\u9002\u914d\u4ee3\u7801\uff0c\u624d\u80fd\u8ba9 swagger \u517c\u5bb9 Mono\u3001Flux\u3002<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\u4e0b\u9762\u6211\u4eec\u4e00\u8d77\u5f00\u59cb\u672c\u6b21\u6559\u7a0b\u7684\u6574\u5408\u4e4b\u65c5\uff0c\u6211\u8fd9\u91cc\u7684 swagger \u7248\u672c\u662f 3.0.0\uff0c2.10.x \u7248\u672c\u7684\u4e5f\u53ef\u4ee5\u6574\u5408\uff0c\u5177\u4f53\u770b\u4f60\u4e2a\u4eba\u5174\u8da3\u548c\u4f60\u4f7f\u7528\u7684 spring-boot-starter-webflux \u7248\u672c\u3002<\/p>\n\n\n\n<div class=\"wp-block-image\"><figure class=\"aligncenter\"><img decoding=\"async\" src=\"https:\/\/cdn.jsdelivr.net\/gh\/xmt1139057136\/xttblog\/2021\/06\/springfox-spring-webflux.png\" alt=\"\" \/><figcaption>springfox-spring-webflux \u7248\u672c\u5217\u8868<\/figcaption><\/figure><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">\u9996\u5148\u662f pom.xml \u4e2d\u7684\u4ee3\u7801\u3002<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>&lt;dependencies&gt;\n    &lt;dependency&gt;\n        &lt;groupId&gt;org.springframework.boot&lt;\/groupId&gt;\n        &lt;artifactId&gt;spring-boot-starter-webflux&lt;\/artifactId&gt;\n        &lt;version&gt;2.1.0.RELEASE&lt;\/version&gt;\n    &lt;\/dependency&gt;\n    &lt;dependency&gt;\n        &lt;groupId&gt;org.springframework.boot&lt;\/groupId&gt;\n        &lt;artifactId&gt;spring-boot-starter-data-mongodb&lt;\/artifactId&gt;\n        &lt;version&gt;2.1.0.RELEASE&lt;\/version&gt;\n    &lt;\/dependency&gt;\n    &lt;dependency&gt;\n        &lt;groupId&gt;io.springfox&lt;\/groupId&gt;\n        &lt;artifactId&gt;springfox-spring-webflux&lt;\/artifactId&gt;\n        &lt;version&gt;${swagger.version}&lt;\/version&gt;\n        &lt;exclusions&gt;\n            &lt;exclusion&gt;\n                &lt;groupId&gt;org.springframework.plugin&lt;\/groupId&gt;\n                &lt;artifactId&gt;spring-plugin-core&lt;\/artifactId&gt;\n            &lt;\/exclusion&gt;\n            &lt;exclusion&gt;\n                &lt;groupId&gt;org.springframework.plugin&lt;\/groupId&gt;\n                &lt;artifactId&gt;spring-plugin-metadata&lt;\/artifactId&gt;\n            &lt;\/exclusion&gt;\n        &lt;\/exclusions&gt;\n    &lt;\/dependency&gt;\n    &lt;dependency&gt;\n        &lt;groupId&gt;io.springfox&lt;\/groupId&gt;\n        &lt;artifactId&gt;springfox-swagger2&lt;\/artifactId&gt;\n        &lt;version&gt;${swagger.version}&lt;\/version&gt;\n        &lt;exclusions&gt;\n            &lt;exclusion&gt;\n                &lt;groupId&gt;org.springframework.plugin&lt;\/groupId&gt;\n                &lt;artifactId&gt;spring-plugin-core&lt;\/artifactId&gt;\n            &lt;\/exclusion&gt;\n            &lt;exclusion&gt;\n                &lt;groupId&gt;org.springframework.plugin&lt;\/groupId&gt;\n                &lt;artifactId&gt;spring-plugin-metadata&lt;\/artifactId&gt;\n            &lt;\/exclusion&gt;\n        &lt;\/exclusions&gt;\n    &lt;\/dependency&gt;\n    &lt;dependency&gt;\n        &lt;groupId&gt;io.springfox&lt;\/groupId&gt;\n        &lt;artifactId&gt;springfox-swagger-ui&lt;\/artifactId&gt;\n        &lt;version&gt;${swagger.version}&lt;\/version&gt;\n    &lt;\/dependency&gt;\n\n    &lt;dependency&gt;\n        &lt;groupId&gt;org.springframework.plugin&lt;\/groupId&gt;\n        &lt;artifactId&gt;spring-plugin-core&lt;\/artifactId&gt;\n        &lt;version&gt;2.0.0.RELEASE&lt;\/version&gt;\n    &lt;\/dependency&gt;\n    &lt;dependency&gt;\n        &lt;groupId&gt;org.springframework.plugin&lt;\/groupId&gt;\n        &lt;artifactId&gt;spring-plugin-metadata&lt;\/artifactId&gt;\n        &lt;version&gt;2.0.0.RELEASE&lt;\/version&gt;\n    &lt;\/dependency&gt;\n&lt;\/dependencies&gt;<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">pom \u4e2d\u5f15\u5165 springfox-spring-webflux \u540e\uff0c\u6211\u4eec\u9700\u8981\u628a spring-plugin-core \u6392\u9664\u6389\uff0c\u5426\u5219\u4f1a\u542f\u52a8\u62a5\u9519\uff0c\u629b\u51fa\u4e0b\u9762\u7c7b\u4f3c\u7684\u5f02\u5e38\u3002<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>2021-06-16 14:52:05.782 ERROR 2368 --- [           main] o.s.b.d.LoggingFailureAnalysisReporter   : \n \n***************************\nAPPLICATION FAILED TO START\n***************************\n \nDescription:\n \nAn attempt was made to call a method that does not exist. The attempt was made from the following location:\n \n    springfox.documentation.spring.web.plugins.DocumentationPluginsManager.createContextBuilder(DocumentationPluginsManager.java:154)\n \nThe following method did not exist:\n \n    org.springframework.plugin.core.PluginRegistry.getPluginOrDefaultFor(Ljava\/lang\/Object;Lorg\/springframework\/plugin\/core\/Plugin;)Lorg\/springframework\/plugin\/core\/Plugin;\n \nThe method's class, org.springframework.plugin.core.PluginRegistry, is available from the following locations:\n \n    jar:file:\/C:\/work\/maven\/mymaven\/repo\/org\/springframework\/plugin\/spring-plugin-core\/1.2.0.RELEASE\/spring-plugin-core-1.2.0.RELEASE.jar!\/org\/springframework\/plugin\/core\/PluginRegistry.class\n \nIt was loaded from the following location:\n \n    file:\/C:\/work\/maven\/mymaven\/repo\/org\/springframework\/plugin\/spring-plugin-core\/1.2.0.RELEASE\/spring-plugin-core-1.2.0.RELEASE.jar\n \n \nAction:\n \nCorrect the classpath of your application so that it contains a single, compatible version of org.springframework.plugin.core.PluginRegistry<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\u4e3a\u4e86\u89e3\u51b3\u8fd9\u4e2a\u95ee\u9898\uff0c\u6211\u4eec\u9700\u8981\u5f15\u5165\u66f4\u9ad8\u7248\u672c\u7684 spring-plugin-core\uff0c\u5c31\u662f\u4e0a\u9762 pom.xml \u4e2d\u6700\u4e0b\u9762\u7684\u4e24\u4e2a\u4f9d\u8d56\u9879\u3002<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\u505a\u5b8c\u7b2c\u4e00\u6b65\u4e4b\u540e\uff0c\u6211\u4eec\u73b0\u5728\u9700\u8981\u5f00\u542f swagger\uff0c\u7f51\u4e0a\u5f88\u591a\u4eba\u4f7f\u7528\u7684\u662f @EnableSwagger2WebFlux \u6ce8\u89e3\uff0c\u90a3\u662f\u56e0\u4e3a\u4ed6\u4eec\u4f7f\u7528\u7684\u662f\u5feb\u7167\u7248\u672c\uff0c\u73b0\u5728\u7684\u6b63\u5f0f\u7248\u672c\u5df2\u7ecf\u628a\u5b83\u5e9f\u5f03\u6389\u4e86 @Deprecated\uff0c\u63a8\u8350\u7684\u8fd8\u662f\u4f7f\u7528 @EnableSwagger2\u3002<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>@Configuration\n@EnableSwagger2\npublic class SwaggerWebFluxConfig {\n    @Bean\n    public Docket createRestApi() {\n        return new Docket(DocumentationType.SWAGGER_2)\n            .apiInfo(new ApiInfoBuilder()\n                    .description(\"\u4e1a\u4f59\u8349 project\")\n                    .title(\"\u4e1a\u4f59\u8349 RESTful APIs\")\n                    .termsOfServiceUrl(\"https:\/\/www.xttblog.com\/\")\n                    .contact(new Contact(\"\u4e1a\u4f59\u8349\", \"https:\/\/www.xttblog.com\/\", \"1139057136@qq.com\"))\n                    .version(\"1.0.0\")\n                    .build())\n            .select()\n            .apis(RequestHandlerSelectors.basePackage(\"com.xttblog.webflux.demo\"))\n            .paths(PathSelectors.any())\n            .build()\n            .genericModelSubstitutes(Optional.class, Flux.class, Mono.class);\n    }\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\u505a\u5b8c\u8fd9\u4e00\u6b65\u4e4b\u540e\uff0c\u8fd8\u4e0d\u884c\u3002\u5982\u679c\u4f60\u76f4\u63a5\u8fd0\u884c\u9879\u76ee\uff0c\u8bbf\u95ee swagger\uff0c\u4f1a\u51fa\u73b0 404\u3002\u7f51\u4e0a\u5f88\u591a\u4eba\u8bf4\u9700\u8981\u5f00\u542f @EnableWebFlux \u6ce8\u89e3\uff0c\u8fd9\u4e00\u6b65\u5176\u5b9e\u662f\u591a\u4f59\u7684\uff0c\u52a0\u4e0a\u4e86\u4e5f\u8fd8\u662f 404\u3002<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>@EnableWebFlux\n@SpringBootApplication\n@ComponentScan(basePackages = {\"com.xttblog.webflux.demo\"},\n        excludeFilters = @ComponentScan.Filter(type = FilterType.ASSIGNABLE_TYPE,\n                classes = {}))\npublic class XttblogApplication {\n\n    public static void main(String[] args) {\n        SpringApplication.run(XttblogApplication.class, args);\n    }\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\u4e00\u756a\u641c\u7d22\u540e\uff0c\u6211\u5728\u5b98\u7f51\u4e0a\u770b\u5230\u4e86 WebFluxConfigurer\uff0c\u901a\u8fc7\u914d\u7f6e\u5b9e\u73b0 WebFluxConfigurer \u540e\uff0c\u53ef\u4ee5\u5b8c\u7f8e\u89e3\u51b3 webflux \u6574\u5408 swagger \u51fa\u73b0 404 \u95ee\u9898\u3002<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>@Configuration\npublic class SwaggerUiWebFluxConfigurer implements WebFluxConfigurer {\n    @Override\n    public void addCorsMappings(CorsRegistry registry) {\n        \/\/ \u914d\u7f6e\u8de8\u57df\n        registry.addMapping(\"\/**\").allowedOrigins(\"*\").allowedMethods(\"GET\", \"POST\", \"OPTION\", \"DELETE\").maxAge(3600);\n    }\n\n    @Override\n    public void addResourceHandlers(ResourceHandlerRegistry registry) {\n        \/\/ \u91cd\u65b0\u6620\u5c04\u8def\u5f84\n        registry.\n                addResourceHandler(\"\/swagger-ui\/**\")\n                .addResourceLocations(\"classpath:\/META-INF\/resources\/webjars\/springfox-swagger-ui\/\")\n                .resourceChain(false);\n\n        registry.addResourceHandler(\"\/swagger-ui.html**\")\n                .addResourceLocations(\"classpath:\/META-INF\/resources\/\");\n\n        registry.addResourceHandler(\"\/webjars\/**\")\n                .addResourceLocations(\"classpath:\/META-INF\/resources\/webjars\/\").resourceChain(true);\n    }\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\u7f51\u4e0a\u6709\u5f88\u591a\u91ce\u4ee3\u7801\uff0c\u90fd\u662f\u57fa\u4e8e 3.0 \u7684\u5feb\u7167\u7248\u672c\uff0c\u6839\u672c\u5c31\u65e0\u6cd5\u89e3\u51b3 404 \u95ee\u9898\uff0c\u5305\u62ec stackoverflow \u7684\u56de\u7b54\u3002<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\u56e0\u4e3a 3.0.0 \u7684\u6b63\u5f0f\u7248\u672c\u4e2d\uff0c\u8bbf\u95ee\u8def\u5f84\u662f http:\/\/localhost:8080\/swagger-ui\/index.html\uff0c\u4e14\u8fd9\u4e9b swagger \u8d44\u6e90\u662f\u653e\u5728 classpath:\/META-INF\/resources\/webjars\/springfox-swagger-ui\/ \u4e0b\u9762\u7684\uff0c\u5f88\u591a\u56de\u7b54\u662f\u628a\u8d44\u6e90\u653e\u5728 classpath:\/META-INF\/resources\/ \u4e0b\uff0c\u5e76\u4e14\u6620\u5c04\u7684\u662f swagger-ui.html\u3002\u8fd9\u662f\u4f4e\u7248\u672c\u7684 swagger \u7684\u505a\u6cd5\uff0c\u6b63\u5f0f\u7248\u672c\u548c\u5feb\u7167\u7248\u672c\u8fd8\u662f\u6709\u5f88\u5927\u5dee\u522b\u7684\uff0c\u5b98\u7f51\u4e0a\u4fee\u590d\u4e86\u5f88\u591a bug\u3002<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\u505a\u5b8c\u4e0a\u9762\u7684\u5de5\u4f5c\u540e\uff0c\u542f\u52a8\u9879\u76ee\uff0c\u6700\u7ec8\u5b9e\u73b0 weblux \u548c swagger3 \u7684\u6574\u5408\uff0c\u63a8\u8350\u4f7f\u7528\u6b63\u5f0f\u7248\u672c\u7684 springfox-spring-webflux\u3002<\/p>\n\n\n\n<div class=\"wp-block-image\"><figure class=\"aligncenter\"><img decoding=\"async\" src=\"https:\/\/cdn.jsdelivr.net\/gh\/xmt1139057136\/xttblog\/2021\/06\/webflux-swagger.png\" alt=\"\" \/><figcaption>springfox-spring-webflux \u6574\u5408 spring-boot-starter-webflux<\/figcaption><\/figure><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">\u66f4\u591a\u5173\u4e8e webflux \u7684\u5b9e\u6218\u6559\u7a0b\uff0c\u53c2\u8003\u300a<a rel=\"noreferrer noopener\" aria-label=\"webflux\u4ece\u5165\u95e8\u5230\u7cbe\u901a\uff08\u5728\u65b0\u7a97\u53e3\u6253\u5f00\uff09\" href=\"https:\/\/www.xttblog.com\/spring-webflux.html\" target=\"_blank\">webflux\u4ece\u5165\u95e8\u5230\u7cbe\u901a<\/a>\u300b\u3002\u5b98\u7f51\u6559\u7a0b\u5730\u5740\uff1a<a href=\"https:\/\/springfox.github.io\/springfox\/docs\/current\/\" target=\"_blank\" rel=\"noreferrer noopener\" aria-label=\"https:\/\/springfox.github.io\/springfox\/docs\/current\/\uff08\u5728\u65b0\u7a97\u53e3\u6253\u5f00\uff09\">https:\/\/springfox.github.io\/springfox\/docs\/current\/<\/a><\/p>\n<!-- <audio autoplay=\"autoplay\" height=\"100\" width=\"100\" hidden=\"true\"><source src=\"https:\/\/c.coka.la\/orAvPR.mp3\" type=\"audio\/mp3\"\/><\/audio><img decoding=\"async\" src=\"https:\/\/images.weserv.nl\/?url=https:\/\/ws3.sinaimg.cn\/large\/8fa5dcfcgy1g4em3rzar5j20ib089ae0.jpg\" alt=\"\u4e1a\u4f59\u8349\u516c\u4f17\u53f7\"\/> --><p><!-- <img decoding=\"async\" src=\"https:\/\/raw.githubusercontent.com\/xmt1139057136\/xttblog\/master\/8fa5dcfcgy1g4em3rzar5j20ib089ae0.jpg\" alt=\"\u4e1a\u4f59\u8349\u516c\u4f17\u53f7\"\/>--><img decoding=\"async\" src=\"https:\/\/saas.51autoparts.cn\/api\/admin\/sys-file\/oss\/file?fileName=84db51f8561e448f9a4fda2eff0811f9.jpg\" alt=\"\u4e1a\u4f59\u8349\u516c\u4f17\u53f7\"\/><\/p><p>\u6700\u540e\uff0c\u6b22\u8fce\u5173\u6ce8\u6211\u7684\u4e2a\u4eba\u5fae\u4fe1\u516c\u4f17\u53f7\uff1a\u4e1a\u4f59\u8349\uff08yyucao\uff09\uff01<b>\u53ef\u52a0\u4f5c\u8005\u5fae\u4fe1\u53f7\uff1a<font color=\"red\">xttblog2<\/font>\u3002\u5907\u6ce8\uff1a\u201c1\u201d\uff0c\u6dfb\u52a0\u535a\u4e3b\u5fae\u4fe1\u62c9\u4f60\u8fdb\u5fae\u4fe1\u7fa4\u3002\u5907\u6ce8\u9519\u8bef\u4e0d\u4f1a\u540c\u610f\u597d\u53cb\u7533\u8bf7\u3002<\/b>\u518d\u6b21\u611f\u8c22\u60a8\u7684\u5173\u6ce8\uff01\u540e\u7eed\u6709\u7cbe\u5f69\u5185\u5bb9\u4f1a\u7b2c\u4e00\u65f6\u95f4\u53d1\u7ed9\u60a8\uff01\u539f\u521b\u6587\u7ae0\u6295\u7a3f\u8bf7\u53d1\u9001\u81f3532009913@qq.com\u90ae\u7bb1\u3002\u5546\u52a1\u5408\u4f5c\u4e5f\u53ef\u6dfb\u52a0\u4f5c\u8005\u5fae\u4fe1\u8fdb\u884c\u8054\u7cfb\uff01<\/p><p>\u672c\u6587\u539f\u6587\u51fa\u5904\uff1a<a href=\"https:\/\/www.xttblog.com\">\u4e1a\u4f59\u8349<\/a>\uff1a &raquo; <a href=\"https:\/\/www.xttblog.com\/?p=5225\">webflux\u6574\u5408swagger\u6559\u7a0b<\/a><\/p><!-- <div class=\"bd-reward-stl\"><button id=\"bdRewardBtn\"><span><\/span><\/button><\/div> -->","protected":false},"excerpt":{"rendered":"<p>\u76f8\u4fe1\u5df2\u7ecf\u6709\u4e0d\u5c11\u4eba\u4e0a\u624b\u4e86 webflux\uff0c\u5305\u62ec\u6211\u4e4b\u524d\u4e5f\u5199\u4e86\u5f88\u591a\u7c7b\u4f3c\u7684\u6574\u5408\u6559\u7a0b\uff0c\u4f46\u662f\u5728\u6574\u5408 swagger \u6846\u67b6\u65b9 [&hellip;]<\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[5],"tags":[1710,1709,2020,603,1701],"class_list":["post-5225","post","type-post","status-publish","format-standard","hentry","category-java","tag-flux","tag-mono","tag-reactive","tag-swagger2","tag-webflux"],"_links":{"self":[{"href":"https:\/\/www.xttblog.com\/index.php?rest_route=\/wp\/v2\/posts\/5225","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.xttblog.com\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.xttblog.com\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.xttblog.com\/index.php?rest_route=\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/www.xttblog.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=5225"}],"version-history":[{"count":2,"href":"https:\/\/www.xttblog.com\/index.php?rest_route=\/wp\/v2\/posts\/5225\/revisions"}],"predecessor-version":[{"id":5227,"href":"https:\/\/www.xttblog.com\/index.php?rest_route=\/wp\/v2\/posts\/5225\/revisions\/5227"}],"wp:attachment":[{"href":"https:\/\/www.xttblog.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=5225"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.xttblog.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=5225"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.xttblog.com\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=5225"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}