javaspring-projects/spring-ai #4185Not a task: already works

Swagger integration not working with Spring AI unless using springdoc-openapi version 2.8.5

envgap__spring-projects__spring-ai-4185

Original GitHub issue ↗Dated source checkout ↗Opened 2025-08-19

01 / FAILURE SIGNATURE

As reported upstream

No identifying execution failure has been captured.

Not a benchmark task.

The project already builds and runs before the fix, so there is nothing to repair.

02 / ENVIRONMENT RECIPE

Base commit: 8caffe85d487f267b5f37ef0194e769675760c1f
Manifest: pom.xml
Reproduce: Awaiting issue-specific recipe
Run under trace: Awaiting a meaningful runtime command

03 / ORIGINAL ISSUE TEXT

spring-projects/spring-ai #4185 · read the original issue

**Bug description**
When integrating Swagger with a Spring AI project, the application fails to start (throws NoSuchMethodError and similar errors) if the springdoc-openapi version is different from 2.8.5.
It seems that Spring AI is not fully compatible with other versions of springdoc-openapi.

**Environment**
Spring AI version: 1.0.1
Java version: 21
Spring Boot version: 3.5.3
Swagger/OpenAPI dependency: springdoc-openapi

**Steps to reproduce**
- Create a Spring AI project.
- Add springdoc-openapi dependency with version different from 2.8.5 (e.g., 2.5.0 or latest).
- Run the application.
- Observe runtime errors related to Swagger integration (e.g., NoSuchMethodError in io.swagger.v3.oas.annotations.Parameter).

**Expected behavior**
Swagger should work with any compatible springdoc-openapi version, not just 2.8.5.

<img width="699" height="444" alt="Image" src="https://github.com/user-attachments/assets/250151f0-1ffb-457c-9529-31dbadaf9e1e" />

Continue on GitHub ↗

04 / LABELS

Labels from the report text only; not yet run

No supported category has been assigned.

Label rules and the text that matched

[]