Skip to content

Default server URL "/" is added automatically when parsing OpenAPI 3 spec #2197

@Talakafafi

Description

@Talakafafi

Description:
When I parse an OpenAPI 3.0 document using new OpenAPIV3Parser().readContents(...), a default server with URL "/" is automatically added if no servers are defined. This causes issues when the document is later used in Swagger UI or serialized with Json.mapper().writeValueAsString(...), as the unwanted "/" base path appears in the output.

Steps to Reproduce:

  1. Use the swagger-parser library to read an OpenAPI spec that has no servers section.
  2. Parse using:
OpenAPI openApi = new OpenAPIV3Parser().readContents(openApiString).getOpenAPI();
String openApiJson = Json.mapper().writeValueAsString(openApi);
  1. Observe that the resulting openApiJson includes:
"servers": [
  {
    "url": "/"
  }
]

Expected Behavior:
If no servers are defined in the input OpenAPI spec, the parser should not add a default server URL, or there should be an option to disable it.

Actual Behavior:
A server with URL "/" is automatically inserted into the servers list.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions