Duplicat #3360

I must admit to being very confused. It seems that there are now multiple releases of 3.0.0-SNAPSHOT version - my .m2 repository has multiple 3.0.0-SNAPSHOT jars, one on 8th May, one on 5th July and one from earlier this morning. All I know is that my OpenAPI docs are now screwed and swagger-ui.html no longer works. I use Google Cloud Endpoints and this now rejects the OpenAPI v2 config doc which differs significantly from an earlier, working version and which is clearly 'odd'. I only switched to 3.0.0-SNAPSHOT because of its support for Spring WebFlux but it is clear that, at the moment, it is simply unusable for me. What is the plan for 3.0.0-SNAPSHOT? Should I switch to 2.10.5 but does that support Spring WebFlux. Sorry, not wanting to sound critical as it is a great product and it is clear to see the effort put it, but I am completely exasperated and wondering how to proceed. Any hints would be greatly appreciated.

@andrew-property-xyz again apologies as things are in a bit of a flux (as expected with snapshots) as I work on getting 3.0.0 released this week. I suspect there is a couple of things going on here. If you're unable to share a repo that demonstrates the problem, would you look at the the demos project especially the boot-webflux repo to see if you can modify it to reflect your problem.

@dilipkrish one doubt, what is the extra features are there in snapshot 3.0.0 that everyone is following the repo in dependency repo compared to 2.10.5 stable. For me, I just copied the version from a blog.

3.0.0 is the latest released version. Please see the release notes for details. 2.10.5 is an intermediate release and not meant for public consumption.

I use 3.0.0 and find the new swagger ui is http://xxxx:port/swagger-ui/ ( please remember the last splash).
actually， you can add spring-boot-starter-actuator and confirm the swagger ui mapping by check http://xxx:port/actuator/mappings .
And my suggestion is restore the url to swagger-ui.html.

Hi @fishjam @dilipkrish
I am facing issues in all cases of url like http://xxxx:port/swagger-ui/ and getting
"message":"Invalid access token"

@pushkaraj20885 you need to allow access to the resources if you have authentication turned on

Hi @dilipkrish
I have added below mentioned code in class WebSecurityConfiguration extends WebSecurityConfigurerAdapter

void configure(final WebSecurity web) { web.ignoring().antMatchers('/v2/api-docs', '/swagger-resources/**', '/swagger-ui/**', '/swagger-ui/index.html**', '/webjars/**', '/actuator/health')

but still getting same error

Please look at @fishjam post. To make it work .../swagger-ui/ NOT .html. That need to be fixed

In spring boot it works by simply adding this, no other dependencies needed:
<dependency> <groupId>io.springfox</groupId> <artifactId>springfox-boot-starter</artifactId> <version>3.0.0</version> </dependency>
The url is /swagger-ui/ , mind the final slash.

Thank you . It worked for me by adding the io.springfox springfox-boot-starter 3.0.0 and with the url http://localhost:8080/swagger-ui/

Hi Guys,

I have to admit, the Swagger project is one of the most confusing library. I finally managed to get this working with springfox-boot-starter 3.0.0

My config:

gradle:
`
plugins {
id 'org.springframework.boot' version '2.4.2'
id 'io.spring.dependency-management' version '1.0.10.RELEASE'
id 'java'
}

group = 'com.curvecue'
version = '0.0.1-SNAPSHOT'
sourceCompatibility = '1.8'

configurations {
compileOnly {
extendsFrom annotationProcessor
}
}

repositories {
mavenCentral()
maven { url 'https://repo.spring.io/milestone' }
}

ext {
set('springCloudVersion', "2020.0.1")
}

//configurations {
// // exclude Tomcat
//// compile.exclude module: 'spring-boot-starter-tomcat'
//}

dependencies {

implementation 'org.springframework.boot:spring-boot-starter-thymeleaf'
implementation 'org.springframework.boot:spring-boot-starter-validation'
implementation 'org.springframework.boot:spring-boot-starter-web'

// implementation 'org.springframework.boot:spring-boot-starter-undertow'
implementation 'org.springframework.boot:spring-boot-starter-actuator'
implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
implementation 'org.springframework.boot:spring-boot-starter-thymeleaf'
implementation 'org.springframework.boot:spring-boot-starter-webflux'

implementation 'org.springframework.cloud:spring-cloud-starter-config'
implementation 'org.springframework.cloud:spring-cloud-starter-openfeign'

implementation 'org.flywaydb:flyway-core:7.5.2'

compile group: 'io.springfox', name: 'springfox-boot-starter', version: '3.0.0'

implementation 'com.fasterxml.jackson.datatype:jackson-datatype-jdk8:2.12.1'

compileOnly 'org.projectlombok:lombok'
developmentOnly 'org.springframework.boot:spring-boot-devtools'
runtimeOnly 'com.h2database:h2'
runtimeOnly 'org.postgresql:postgresql'
annotationProcessor 'org.springframework.boot:spring-boot-configuration-processor'
annotationProcessor 'org.projectlombok:lombok'
testImplementation 'org.springframework.boot:spring-boot-starter-test'
testImplementation 'io.projectreactor:reactor-test'

}

dependencyManagement {
imports {
mavenBom "org.springframework.cloud:spring-cloud-dependencies:${springCloudVersion}"
}
}

test {
useJUnitPlatform()
}
`

@configuration
@EnableSwagger2
public class SwaggerConfig extends WebMvcConfigurerAdapter {
@bean
public Docket apiDocket() {
return new Docket( DocumentationType.SWAGGER_2 )
.select()
.apis( RequestHandlerSelectors.any() )
.paths( PathSelectors.any() )
.build();
}
}

Sample RestController
`
@RestController
@RequestMapping( "/stream-api/postgres" )
@requiredargsconstructor
@slf4j
public class PostgresController {

private final UserRepository userRepository;

@GetMapping( value = "/user", produces = MediaType.APPLICATION_NDJSON_VALUE )
public UserEntity getUser( @RequestParam( required = true ) String id ) {
	log.debug( "Looking up for user with id: {}", id );
	Optional<UserEntity> userEntityOptional = userRepository.findById( id );
	return userEntityOptional.orElse( null );
}

}
`

And now most importantly the url:
http://localhost:8080/swagger-ui/index.html <-- PLS NOTICE there is no context root specified here. I spent hours pointing to http://localhost:8080/stream-api/postgres/swagger-ui/index.html !

Hope this helps. I didn't have to make any Spring Security adjustments.

new url is /swagger-ui/, and the / at end is necessary !!!

new url is /swagger-ui/, and the / at end is necessary !!!

@kuchaguangjie Thank you so much. I spent an hour trying every possible approach only to figure out that I was missing a '/' at the end of the url.

        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-boot-starter</artifactId>
            <version>3.0.0</version>
        </dependency>

Hello, I added this dependency to pom.xml (this is the only dependency pointing to sprinfox) and still getting error while accessing /swagger-ui/. On the other hand v2/api-docs works well. I didn't create any configuration classes. Does anyone know, what can be wrong here? Any pointers are appreciated!

new url is /swagger-ui/, and the / at end is necessary !!!

Thank you, finally works for me!!!

While using the following dependencies, only http://localhost:8080/v2/api-docs is working not this http://localhost:8080/swagger-ui/

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

However, if you add the below dependency instead of the above one, both are working well

    <dependency>
          <groupId>io.springfox</groupId>
          <artifactId>springfox-boot-starter</artifactId>
          <version>3.0.0</version>
    </dependency>

Incredible how a library is too confused!
I spent already 3 hours trying to fix my simple project, but nothing yet.

This works: http://localhost:8080/v2/api-docs
This does not work: http://localhost:8080/swagger-ui/, http://localhost:8080/stream-api/postgres/swagger-ui/index.html

Something missing?

No solution worked for me yet

io.springfox springfox-boot-starter 3.0.0

This worked for swagger version 3.0.0

After spending several hours I found out in my case spring cloud config server caused the problem, see this and this. Since path conflict was the main reason of the problem, it's possible to happen in any other cases where path conflict exists, for example when base path of a rest service is / and there is a method with a @PathParam argument or when there is another tool like config server that hijacks url!

We are not using springboot application and but they are trying to update the swagger from 2.9.2 to 3.0.0 version and we are facing swagger.html issue 404.
I tried swagger-ui/index.html also but no luck.

Could you please help on this to work?

currently i am using springfox 3.0.0 with spring-boot 2.7.1 version. below link solutions doesn't work for me.
i spend couples of days on it but no luck. can anyone help me for this its urgent, need to solve it ASAP.
(http://springfox.github.io/springfox/docs/current/#migrating-from-existing-2-x-version)
below issue i am getting
Whitelabel Error Page
This application has no explicit mapping for /error, so you are seeing this as a fallback.
Mon Jul 06 21:19:55 AEST 2020
There was an unexpected error (type=Not Found, status=404).

while using swagger-ui urls.
http://localhost:8081/api-payroll-ng/docs/swagger-ui
http://localhost:8081/api-payroll-ng/docs/swagger-ui/index.html

currently i am using springfox 3.0.0 with spring-boot 2.7.1 version. below link solutions doesn't work for me. i spend couples of days on it but no luck. can anyone help me for this its urgent, need to solve it ASAP. (http://springfox.github.io/springfox/docs/current/#migrating-from-existing-2-x-version) below issue i am getting Whitelabel Error Page This application has no explicit mapping for /error, so you are seeing this as a fallback. Mon Jul 06 21:19:55 AEST 2020 There was an unexpected error (type=Not Found, status=404).

while using swagger-ui urls. http://localhost:8081/api-payroll-ng/docs/swagger-ui http://localhost:8081/api-payroll-ng/docs/swagger-ui/index.html

Have you manage to sort this?

none of the mentioned solutions are working for me, following is my configuration:

plugins {
	id 'java'
	id 'org.springframework.boot' version '3.1.8'
	id 'io.spring.dependency-management' version '1.1.4'
	id("io.swagger.core.v3.swagger-gradle-plugin") version "2.2.19"
}

Any help would be appreciated