SpringDoc Incorrectly Generates Schema When Using Record Named "Item"

[MikeMJ]

Describe the bug

I encountered an issue with SpringDoc OpenAPI when using a Java record named Item. The generated schema incorrectly places the reason field from the Serial record as a direct field of Item, while the serial field is completely ignored. Additionally, the Serial record is not documented as a separate schema at all.

Example record definition:

public record Item(
    String itemNo,
    String material,
    String quantity,
    List<Serial> serials
) {}

public record Serial(
    String serial,
    String reason
) {}

However, when I rename Item to Item2, the schema is generated correctly. This suggests a possible naming conflict affecting schema generation.

Could you please confirm whether this is a bug or an expected limitation?

Let me know if you need more details or sample output.

To Reproduce
Steps to reproduce the behavior:

• Spring boot: 3.2.0
• 'org.springdoc:springdoc-openapi-starter-webmvc-ui:2.3.0'
• Expected and actual attached as files

actual.txt

expected.txt

Below are the sample records and the controller that uses the wrapper one. (Item)

public record Item(
    String itemNo,
    String material,
    String quantity,
    List<Serial> serials
) {}

public record Serial(
    String serial,
    String reason
) {}

@RestController
public class ItemsController{
   public void add(@RequestBody Item item){
   }
}

[MikeMJ]

Document generated with record named "Item"

Document generated with record named "Item2:

[bnasslahsen]

@MikeMJ,

This the generated spec, with the latest release:

openapi: 3.1.0
info:
  title: OpenAPI definition
  version: v0
servers:
  - url: http://localhost:8080
    description: Generated server url
paths:
  /hello:
    get:
      tags:
        - hello-controller
      operationId: getItem
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/Item'
components:
  schemas:
    Item:
      type: object
      properties:
        itemNo:
          type: string
        material:
          type: string
        quantity:
          type: string
        serials:
          type: array
          items:
            $ref: '#/components/schemas/Serial'
    Serial:
      type: object
      properties:
        serial:
          type: string
        reason:
          type: string