swagger-api / swagger-api/swagger-ui

Swagger-UI endpoint 404 (5.32.1 - 5.32.4)

Open
#10,855 2 comments 3 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
JavaScript
Stars
29k
Forks
9.3k
Avg merge
2d 23h
Merged PRs (30d)
25

Description

Q&A
  • OS: macOS
  • Browser: chrome
  • Version: 147.0.7727.102
  • Method of installation: java spring-boot
  • Swagger-UI version: 5.32.1 - 5.32.4
  • Swagger/OpenAPI version: OpenAPI 3.0
Content & configuration

Gradle spring-boot project with webmvc module and added constrain to update 5.32.0 to 5.32.1 ( or 5.32.4 )

Example Swagger/OpenAPI definition:

N/A

Swagger-UI configuration options:

@OpenAPIDefinition(
        info = @Info(
                title = "TMKP Backend API",
                version = "1.0",
                description = "API documentation for TMKP Backend Service"
        ),
        security = @SecurityRequirement(name = "Bearer Authentication")
)
@SecurityScheme(
        name = "Bearer Authentication",
        type = SecuritySchemeType.HTTP,
        bearerFormat = "JWT",
        scheme = "bearer",
        description = "JWT Bearer token authentication.
)
N/A
Describe the bug you're encountering

While upgrading the Swagger-UI dependency on a gradle spring-boot project to 5.32.1 ( also 5.32.4 ) we noticed that the endpoint "/swagger-ui/index.html" is returning 404

Thu Apr 23 15:53:16 WEST 2026
There was an unexpected error (type=Not Found, status=404).

To reproduce...

Steps to reproduce the behavior:

  1. Add dependency to the gradle project to use the latest minor version ( 5.32.4 )
  2. Go to '/swagger-ui/index.html'
  3. See 404 error
Expected behavior

The swagger-ui page is shown.

Screenshots

N/A

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reproducing the Gradle Spring Boot webmvc setup with Swagger UI 5.32.0, then compare it with 5.32.1 and 5.32.4 while requesting /swagger-ui/index.html. Check whether the endpoint serves the Swagger UI page after the dependency upgrade; done means the page loads instead of returning 404.

Written by the indexing model from the issue text.

Assessment

Tech stack
javascript, spring-boot
Domain
api, documentation
Issue type
Bug
Difficulty
3/5
Estimated time
1-2 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
48/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.