Skip to content

chore(deps): bump org.springdoc:springdoc-openapi-starter-webmvc-ui from 2.8.17 to 3.2.0 - #2

Closed
dependabot[bot] wants to merge 1 commit into
mainfrom
dependabot/maven/org.springdoc-springdoc-openapi-starter-webmvc-ui-3.2.0
Closed

dependabot[bot] wants to merge 1 commit into
mainfrom
dependabot/maven/org.springdoc-springdoc-openapi-starter-webmvc-ui-3.2.0

Conversation

@dependabot

@dependabot dependabot Bot commented on behalf of github Nov 16, 2026 •

Copy link
Copy Markdown

Bumps org.springdoc:springdoc-openapi-starter-webmvc-ui from 2.8.17 to 3.2.0.

Release notes

Sourced from org.springdoc:springdoc-openapi-starter-webmvc-ui's releases.

springdoc-openapi v3.2.0 released!

Spring Boot 4.1.x line (built on Spring Boot 4.1.2).

⚠️ Changes you may notice

  • Default API version (#3354): the default API version is now only listed in the version header or query parameter of the operations that actually serve it (a handler mapped to it, or one without a version). Operations mapped only to other versions no longer show it as an allowed value or as their default. This also fixes the HTTP 500 raised when the version parameter declared @Schema(allowableValues).
  • Newly required properties (#3360, #3361): the PagedModel / PageMetadata properties and the amount / currency properties of MonetaryAmount are now marked as required, as they are always serialized. Generated clients will see them as non-nullable.
  • Scalar 0.6 (#3359): upgraded to 0.6.83. The first tag is now open by default, and model links changed from #model/name to #models/Name.
  • Scalar's standalone integration (#3387): with the Swagger UI or API-only starters, Scalar's own auto-configuration is no longer disabled by springdoc. If you have com.scalar.maven on the classpath and don't want it, set scalar.enabled=false.

New

  • Opt-in nullability for Java models (#3382): springdoc.model-converters.java-nullable-property-customizer.enabled=true marks properties annotated with @Nullable (JSpecify, Spring, JSR-305) as nullable, including $ref and oneOf properties, without changing shared components.
  • Polymorphic oneOf as reusable components (#3390): springdoc.model-converters.polymorphic-converter.one-of-as-ref=true, with the name suffix set by springdoc.model-converters.polymorphic-converter.one-of-ref-suffix (Variant by default).
  • ParameterCustomizer can read type-use annotations, including inside Optional<@MyAnnotation Foo> (#3370).
  • MCP tools are registered with a McpStatelessSyncServer, for the Spring AI STATELESS protocol (#3388).

Fixed

  • @ResponseStatus on a controller class is applied to its operations (#3352).
  • An injected WebSession is no longer documented as a query parameter in WebFlux (#3355).
  • The application no longer fails to start with Spring HATEOAS on the classpath but no LinkRelationProvider bean (#3364).
  • WebAsyncTask return types are unwrapped (#3368).
  • A JSpecify @Nullable on a controller parameter makes its schema nullable (#3377).
  • Nullable Kotlin properties described by a oneOf (e.g. sealed classes) are documented as nullable (#3381).
  • Gradle builds no longer lift Jackson 2 above the version managed by Spring Boot (#3373).

Security

  • The MCP dashboard no longer pre-fills the OAuth2 token endpoint, client id and client secret, and warns when the token endpoint is not HTTPS.

Dependencies

Spring Boot 4.1.2 · swagger-ui 5.34.0 · Scalar 0.6.83 · Spring AI 2.0.1 · Spring Cloud Function 5.0.5 · spring-security-oauth2-authorization-server managed by Spring Boot (7.1.2)

Thanks to all the contributors of this release: @​MaxFreedomPollard, @​kdelay, @​arimu1, @​dpkass, @​anupamchaubey, @​Mattias-Sehlstedt, @​Naresh7175, @​ys0v9, @​sharanggupta, @​itd-sw, @​gwr0-0, @​Tework123, @​awinishere.

springdoc-openapi v3.1.1 released!

Security

  • GHSA-6f5m-mhjg-qwxq – MCP tool callbacks do not encode path parameters, allowing request retargeting
  • GHSA-4v2q-56v7-2cpw – MCP transport, admin and dashboard endpoints are exposed by default
  • GHSA-m4cg-mhpg-rh2r – MCP audit events record credentials and request/response bodies without redaction
  • GHSA-5f9r-4mc4-qh3c – Unbounded MCP pending-confirmation store allows memory exhaustion
  • GHSA-jcgg-59c8-w4wh – MCP request context in a ThreadLocal can leak headers between concurrent WebFlux requests
  • GHSA-rhhx-6j8h-8cvw – Unbounded per-locale OpenAPI cache allows memory exhaustion via Accept-Language
  • GHSA-c925-vm88-mpp9 – Scalar starters trust client-supplied forwarded headers and render from a shared mutable bean
  • CVE-2026-75838 – Cross-site scripting in the DOMPurify bundled with swagger-ui, addressed by upgrading swagger-ui to 5.32.14

Added

... (truncated)

Changelog

Sourced from org.springdoc:springdoc-openapi-starter-webmvc-ui's changelog.

[3.2.0] - 2026-10-24

Added

  • #3370 – A ParameterCustomizer can read the type-use annotations of a parameter, including the ones declared on the value wrapped in an Optional, such as Optional<@MyAnnotation Foo>
  • #3382 – Mark the Java properties annotated with @Nullable (JSpecify, Spring, JSR-305) as nullable in their schema, including $ref and oneOf properties. Opt-in with springdoc.model-converters.java-nullable-property-customizer.enabled=true
  • #3390 – Add springdoc.model-converters.polymorphic-converter.one-of-as-ref to emit the polymorphic oneOf unions as reusable component schemas, named after the parent schema with the suffix set by springdoc.model-converters.polymorphic-converter.one-of-ref-suffix (Variant by default)
  • #3388 – Register the MCP tools with a McpStatelessSyncServer, for the STATELESS protocol

Changed

  • The MCP dashboard no longer pre-fills the OAuth2 token endpoint, client id and client secret. The form shows hints instead, and warns when the token endpoint is not HTTPS
  • #3354 – The default API version is only listed in the header or query parameter of the operations that serve it: a handler method mapped to it, or one without a version
  • #3360 – The properties of Spring Data PagedModel and its PageMetadata are now marked as required, as they are always serialized
  • #3361 – The amount and currency properties of MonetaryAmount are now marked as required
  • #3359 – Upgrade Scalar to version 0.6.83. The first tag is now open by default, and the links to models changed from #model/name to #models/Name
  • #3383 – Upgrade Spring AI to version 2.0.1. The MCP SDK version is now the one required by Spring AI
  • Upgrade spring-boot to version 4.1.2
  • Upgrade swagger-ui to version 5.34.0
  • Upgrade spring-cloud-function to version 5.0.5
  • Use the spring-security-oauth2-authorization-server version managed by Spring Boot (7.1.2) instead of 2.0.0-M2

Fixed

  • #3352 – A @ResponseStatus on a controller class is now applied to the responses of its operations
  • #3355 – An injected WebSession parameter is no longer documented as a query parameter in WebFlux applications
  • #3354 – /v3/api-docs no longer fails when an API version parameter declares @Schema(allowableValues)
  • #3364 – The application no longer fails to start when Spring HATEOAS is on the classpath without a LinkRelationProvider bean
  • #3368 – A WebAsyncTask return type is now unwrapped, so its response is described by its result type
  • #3377 – A JSpecify @Nullable on a controller method parameter now makes its schema nullable
  • #3381 – A nullable Kotlin property described by a oneOf schema, such as a sealed class, is now documented as nullable
  • #3387 – Scalar's own integration works again with the Swagger UI and API-only starters: only the Springdoc Scalar starters replace it
  • #3373 – springdoc no longer lifts Jackson 2 above the version managed by Spring Boot in Gradle builds

[3.1.1] - 2026-09-06

Security

  • GHSA-6f5m-mhjg-qwxq – MCP tool callbacks do not encode path parameters, allowing request retargeting
  • GHSA-4v2q-56v7-2cpw – MCP transport, admin and dashboard endpoints are exposed by default
  • GHSA-m4cg-mhpg-rh2r – MCP audit events record credentials and request/response bodies without redaction
  • GHSA-5f9r-4mc4-qh3c – Unbounded MCP pending-confirmation store allows memory exhaustion
  • GHSA-jcgg-59c8-w4wh – MCP request context in a ThreadLocal can leak headers between concurrent WebFlux requests
  • GHSA-rhhx-6j8h-8cvw – Unbounded per-locale OpenAPI cache allows memory exhaustion via Accept-Language
  • GHSA-c925-vm88-mpp9 – Scalar starters trust client-supplied forwarded headers and render from a shared mutable bean
  • CVE-2026-75838 – Cross-site scripting in the DOMPurify bundled with swagger-ui, addressed by upgrading swagger-ui to 5.32.14

Added

  • #3340 – Describe JsonNullable values without their Java wrapper

... (truncated)

Commits
  • 6b79ced [maven-release-plugin] prepare release v3.2.0
  • 689fc13 Describe the nullable property customizer flags in the configuration metadata
  • 7a1b506 Correct the LocalTime format in the changelog entry of gh-3351
  • 96245a2 Upgrade Scalar to 0.6.83
  • c494456 Build against the GA versions of the optional Spring dependencies
  • 2d4595f Restore the changelog entries lost in the unreleased fixed section
  • dd807bd Upgrade swagger-ui to version 5.34.0
  • e649960 Upgrade spring-boot to 4.1.2
  • b170ca8 Use the Jackson 2 managed by Spring Boot
  • ae52fe7 Register the MCP tools with a McpStatelessSyncServer
  • Additional commits viewable in compare view

@dependabot dependabot Bot added dependencies Pull requests that update a dependency file java Pull requests that update java code labels Nov 16, 2026
Bumps [org.springdoc:springdoc-openapi-starter-webmvc-ui](https://github.com/springdoc/springdoc-openapi) from 2.8.17 to 3.2.0.
- [Release notes](https://github.com/springdoc/springdoc-openapi/releases)
- [Changelog](https://github.com/springdoc/springdoc-openapi/blob/main/CHANGELOG.md)
- [Commits](springdoc/springdoc-openapi@v2.8.17...v3.2.0)

---
updated-dependencies:
- dependency-name: org.springdoc:springdoc-openapi-starter-webmvc-ui
  dependency-version: 3.2.0
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
@dependabot dependabot Bot changed the title Bump org.springdoc:springdoc-openapi-starter-webmvc-ui from 2.8.9 to 3.2.0 chore(deps): bump org.springdoc:springdoc-openapi-starter-webmvc-ui from 2.8.17 to 3.2.0 Nov 16, 2026
@dependabot
dependabot Bot force-pushed the dependabot/maven/org.springdoc-springdoc-openapi-starter-webmvc-ui-3.2.0 branch from beb6cc3 to 5c99b7d Compare November 16, 2026 11:20
@jimi-21

jimi-21 commented Nov 17, 2026

Copy link
Copy Markdown
Owner

Closing this automated major-version update because it is not compatible with the current Spring Boot 3 baseline. CI run https://github.com/jimi-21/robotwin-evaluation-platform/actions/runs/43856931080 fails during application startup: both Spring Boot 4 org.springframework.boot.webmvc.autoconfigure.error.ErrorMvcAutoConfiguration and Boot 3 org.springframework.boot.autoconfigure.web.servlet.error.ErrorMvcAutoConfiguration register conventionErrorViewResolver, causing BeanDefinitionOverrideException. The main branch at 3c2e1cd with springdoc 2.8.17 passes CI. A future springdoc 3 upgrade should be tested as a coordinated Spring Boot 4 migration, not merged as a red isolated dependency bump.

@jimi-21 jimi-21 closed this Nov 17, 2026
@dependabot @github

dependabot Bot commented on behalf of github Nov 17, 2026

Copy link
Copy Markdown
Author

OK, I won't notify you again about this release, but will get in touch when a new version is available. If you'd rather skip all updates until the next major or minor version, let me know by commenting @dependabot ignore this major version or @dependabot ignore this minor version. You can also ignore all major, minor, or patch releases for a dependency by adding an ignore condition with the desired update_types to your config file.

If you change your mind, just re-open this PR and I'll resolve any conflicts on it.

@dependabot
dependabot Bot deleted the dependabot/maven/org.springdoc-springdoc-openapi-starter-webmvc-ui-3.2.0 branch November 17, 2026 12:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

dependencies Pull requests that update a dependency file java Pull requests that update java code

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant