spring boot集成 swagger

swagger 配置类

package com.karakal.speclib.config;import org.springframework.context.annotation.Bean;import org.springframework.context.annotation.Configuration;import springfox.documentation.builders.ApiInfoBuilder;import springfox.documentation.builders.ParameterBuilder;import springfox.documentation.builders.PathSelectors;import springfox.documentation.builders.RequestHandlerSelectors;import springfox.documentation.schema.ModelRef;import springfox.documentation.service.ApiInfo;import springfox.documentation.service.Parameter;import springfox.documentation.spi.DocumentationType;import springfox.documentation.spring.web.plugins.Docket;import springfox.documentation.swagger2.annotations.EnableSwagger2;import java.util.ArrayList;import java.util.List;/** * swagger 配置类 */@Configuration@EnableSwagger2public class SwaggerConfig {    public static final  String auth="eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1aWQiOjE3OSwicGVybWlzc2lvbnMiOlsiY2F0YWxvZyIsInByby9wcm8taW4tY2hlY2tzb25nIiwic29uZy9zb25nX3NlcGFyYXRlIiwicHJvL3Byby1pbi1uZXdzb25nIiwiYWxidW0vYWxidW1fZXhwb3J0IiwidG9wL3RvcF9rYXJha2FsX2FsbCIsInRhZy90YWdfdHJlZS90YWdfdHJlZV9iYXRjaHN1Ym1pdCIsInF1YWxpdHlfY29udGVudC9xdWFsaXR5LWFsYnVtL3F1YWxpdHlfYWxidW1fZWRpdCIsInByby9wcm8taW4tY2hlY2thcnRpc3QiLCJ0YWcvdGFnX21hbmFnZS90YWdfbWFuYWdlX2Rpc2FibGUiLCJzb25nL3Nvbmdfb2ZmbGluZSIsImFydGlzdC9hcnRpc3RfYWxidW1fZXhwb3J0IiwidGFnL3RhZ190cmVlL3RhZ190cmVlX2VkaXQiLCJzb25nL3NvbmdfbWVyZ2UiLCJwcm8vdWNfcHJvamVjdF9uZXciLCJzb25nIiwidG9wL3NvbmdfbGFjayIsImFsYnVtL2FsYnVtX3NhdmUiLCJxdWFsaXR5X2NvbnRlbnQvcXVhbGl0eS1zb25nIiwiY2F0YWxvZy9jYXRhbG9nLWhhbmQvY2F0YWxvZ19idG4iLCJzb25nL3Nvbmdfc2F2ZSIsInRhZy90YWdfdHJlZS90YWdfdHJlZV9hZGQiLCJnYXJiYWdlL2dhcmJhZ2Utc29uZy9leHBvcnQiLCJhcnRpc3QvYXJ0aXN0X3NvbmdfZXhwb3J0IiwidG9wL3RvcF9kYXkiLCJhcnRpc3QvYXJ0aXN0X3NlcGFyYXRlIiwibXYvbXZfZXhwb3J0IiwidGFnL3RhZ19tYW5hZ2UvdGFnX21hbmFnZV9jbGljayIsImNvbW1lbnQvY29tbWVudC1zb25nZm9ybSIsInNvbmcvc29uZ190YWdnaW5nIiwicXVhbGl0eV9jb250ZW50L3F1YWxpdHlfZXhwb3J0Iiwic29uZy9zb25nX29ubGluZSIsInNwZWNpYWwvc3BlY2lhbF90dmZpbG0iLCJzb25nL3NvbmdfYXNzaWduIiwidGFnL3RhZ19tYW5hZ2UvdGFnX21hbmFnZV9pbXBvcnQiLCJjb21tZW50L2NvbW1lbnQtYWxidW0iLCJ1Yy91Y19hdXRob3JpdHkiLCJhbGJ1bS9hbGJ1bV9hc3NpZ24iLCJ0YWcvdGFnX3RyZWUiLCJhcnRpc3QiLCJ0YWcvdGFnZ2luZyIsIm12L212X3N1Ym1pdCIsImFsYnVtL2FsYnVtX3Bhc3MiLCJ0b3AiLCJ0YWcvdGFnX3RyZWUvdGFnX3RyZWVfcmVtb3ZlIiwiYWxidW0vYWxidW1fZmxvdyIsImppdXRpYW5fc29uZ19mb3JtIiwidGFnL3RhZ19tYW5hZ2UiLCJyZWlzc3VlIiwic29uZy9zb25nX2V4cG9ydCIsIm12L212X2ltcG9ydCIsInByby9wcm8taW4tcHJlY2F0YWxvZyIsInNvbmcvc29uZ19mbG93IiwicXVhbGl0eV9jb250ZW50L3F1YWxpdHktc29uZy9xdWFsaXR5X3NvbmdfZWRpdCIsImdhcmJhZ2UvZ2FyYmFnZS1zb25nL2VkaXQiLCJhcnRpc3QvYXJ0aXN0X2V4cG9ydCIsImFydGlzdC9hcnRpc3RfaW1wb3J0IiwiYXJ0aXN0L2FydGlzdF9wYXNzIiwidGFnL3RhZ190cmVlL3RhZ190cmVlX3N1Ym1pdCIsImFydGlzdC9hcnRpc3RfYXNzaWduIiwiYWxidW0vYWxidW1fbWVyZ2UiLCJhdGFncyIsImFsYnVtL2FsYnVtX2ltcG9ydCIsImNoYXJ0cy9jaGFydHNfY2F0Y2giLCJhcnRpc3QvYXJ0aXN0X2Zsb3ciLCJjaGFydHMiLCJhcnRpc3QvYXJ0aXN0X3NhdmUiLCJjb21tZW50L2NvbW1lbnQtc29uZyIsInByby9wcm8taW4tY2hlY2thbGJ1bSIsInRhZy90YWdfbWFuYWdlL3RhZ19tYW5hZ2VfcGFzcyIsImdhcmJhZ2UvZ2FyYmFnZS1zb25nIiwidGFnL3F1YWxpdHktdGFnIiwidWMiLCJxdWFsaXR5X2NvbnRlbnQvcXVhbGl0eV9pbXBvcnQiLCJtdi9tdl9lZGl0IiwibXYvbXZfZGV0YWlsIiwiYXRhZ3MvYXRhZ3Mtam9icyIsInRvcC90b3Bfd2Vlay90b3Bfd2Vla19leHBvcnQiLCJwcm8vcHJvLWluLXByb2plY3RjZW50ZXIvcHJvX2NyZWF0ZSIsInByby9wcm8taW4tcHJvamVjdGNlbnRlciIsInRhZyIsInByby91Y19wcm9qZWN0X2Z6ciIsInRvcC90b3BfZGF5L3RvcF9kYXlfZXhwb3J0IiwiYXJ0aXN0L2FydGlzdF9hbGJ1bV9tZXJnZSIsInByby9wcm8taW4tZXhhbWluZSIsInNvbmcvc29uZ19pbXBvcnQiLCJtdi9tdl9hc3NpZ24iLCJhbGJ1bS9hbGJ1bV9zZXBhcmF0ZSIsImdhcmJhZ2UiLCJtdiIsInRhZy90YWdfdHJlZS90YWdfdHJlZV9kZXRhaWwiLCJwcm8iLCJhdGFncy9hdGFncy10YWdzIiwiY29tbWVudC9jb21tZW50X3NhdmUiLCJxdWFsaXR5X2NvbnRlbnQiLCJjYXRhbG9nL2NhdGFsb2ctaGFuZCIsImFydGlzdC9hcnRpc3RfbWVyZ2UiLCJ0YWcvdGFnX21hbmFnZS90YWdfbWFuYWdlX2JhdGNocGFzcyIsInF1YWxpdHlfY29udGVudC9xdWFsaXR5LWFydGlzdC9xdWFsaXR5X2FydGlzdF9lZGl0IiwidGFnL3RhZ19tYW5hZ2UvdGFnX21hbmFnZV9kZWZhdWx0Iiwic3BlY2lhbC9zcGVjaWFsLXNvbmciLCJ0YWcvdGFnX3NvbmciLCJ0YWcvdGFnX3JlbGF0aW9uc2hpcCIsInNvbmdfZm9ybSIsInNvbmcvc29uZ19wb3N0Iiwicm9vdCIsImFsYnVtL2FsYnVtX3Bvc3QiLCJ1Yy91Yy1kaWN0aW9uYXJ5IiwibXYvbXZfbWVyZ2UiLCJ0b3AvdG9wX3dlZWsiLCJxdWFsaXR5X2NvbnRlbnQvcXVhbGl0eS1hbGJ1bSIsInRvcC9zb25nX2xhY2svc29uZ19sYWNrX2ltcG9ydCIsImdhcmJhZ2UvZ2FyYmFnZS1zb25nL2ltcG9ydCIsInRhZy90YWdfbWFuYWdlL3RhZ19tYW5hZ2VfZXhwb3J0IiwiYWxidW0iLCJ1Yy91Yy10aW1ldGFzayIsImdhcmJhZ2UvZ2FyYmFnZS1zb25nL2RlbGV0ZSIsInRvcC9zb25nX2xhY2svc29uZ19sYWNrX2V4cG9ydCIsImFydGlzdC9hcnRpc3RfYWxsIiwiYXJ0aXN0L2FydGlzdF9uZXciLCJxdWFsaXR5X2NvbnRlbnQvcXVhbGl0eV9jb250ZW50X2RlbGV0ZSIsIm12L212X25ldyIsInNwZWNpYWwiLCJnYXJiYWdlL2dhcmJhZ2Utc29uZy9kZWxldGVfYmF0Y2giLCJxdWFsaXR5X2NvbnRlbnQvcXVhbGl0eS1hcnRpc3QiLCJwcm8vcHJvLWluLWhhbmRjYXRhbG9nIiwiYXJ0aXN0L2FydGlzdF9wb3N0IiwiY29tbWVudCIsImFsYnVtL2FsYnVtX25ldyIsInNvbmcvc29uZ19uZXciLCJ0YWcvdGFnX21hbmFnZS90YWdfbWFuYWdlX3VuY2xpY2siXSwicm9sZXMiOlsi57O757uf566h55CG5ZGYIl0sImlzcyI6IkthcmFrYWzlubPlj7Dov5DokKXpg6giLCJjdGltZSI6MTQ5NTI0NDc2NjU1NiwidXNlciI6eyJhY2Nlc3NUb2tlbiI6IjU5ODgxOWYwZjZhZmYzYzljNDlkZGQ1MDFkZWViMzIzYWEwOGQ1NzM4YzAwYTViMTkzOTI5NDhmNmRhN2Y1NmUiLCJjdGltZSI6MTQ5MDU4MzI2ODAwMCwiZW1haWwiOiJtaW5ncXVhbi55YW5nQGthcmFrYWwuY29tLmNuIiwiaWQiOjE3OSwibmFtZSI6IuadqOaYjuadgyIsInN0YXR1cyI6MSwidHlwZSI6MiwidXNlcm5hbWUiOiJ5YW5nbWluZ3F1YW4iLCJ1dGltZSI6MTQ5MDU4MzI2ODAwMCwid2ViVXJsIjoiaHR0cDovL3Rlc3Qua2FyYWthbC5jb20uY246MTgwODkvZ2l0L3UveWFuZ21pbmdxdWFuIn0sInV1aWQiOiJmZThjYWUwMC0xMGUzLTQzNjgtOTYwZC00OGY4YzNhM2FjY2MifQ==.af556685888a69e3a970921bd5eb37038a2ffeae6a644cc6721e66ea6a74931a";    @Bean    public Docket createRestApi() {        ParameterBuilder aParameterBuilder = new ParameterBuilder();        aParameterBuilder.name("Authorization").defaultValue(auth).name("Authorization").modelRef(new ModelRef("String")).parameterType("header").required(false).build();        List<Parameter> aParameters = new ArrayList<Parameter>();        aParameters.add(aParameterBuilder.build());        return new Docket(DocumentationType.SWAGGER_2)                .apiInfo(apiInfo())                .globalOperationParameters(aParameters)                .select()                .apis(RequestHandlerSelectors.basePackage("com.karakal.speclib.controller"))                .paths(PathSelectors.any())                .build();    }    private ApiInfo apiInfo() {        return new ApiInfoBuilder()                .title("Mzk 专项库 APIs")                .version("2.0")                .build();    }}

引入jar包

<!-- swagger --><dependency>    <groupId>io.springfox</groupId>    <artifactId>springfox-swagger2</artifactId>    <version>2.6.1</version></dependency><dependency>    <groupId>io.springfox</groupId>    <artifactId>springfox-swagger-ui</artifactId>    <version>2.6.1</version></dependency>

注意点：

fastjson版本，1.1.12版本，启动后访问swagger 会出现fetching resource ... please wait ，这条提示。改为1.1.16，就好了。

controller 类上需要添加 @RequestMapping("/")，前台会404，后台会提示o.s.web.servlet.PageNotFound - Request method 'GET' not supported