Spring Boot 4.0.0 + Spring Doc 3.0.0 + Kotlin: Ignoring Jackson 3 (tools.jackson) and @Schema annotation

[nico-arianto]

Describe the bug

• isX: Boolean is documented as x
• SnakeCaseStrategy Jackson 3 is ignored
• @param:Schema annotation is ignored

To Reproduce
Steps to reproduce the behavior:

• What version of spring-boot you are using? 4.0.0
• What modules and versions of springdoc-openapi are you using? 3.0.0
• What is the actual and the expected result using OpenAPI Description (yml or json)? json
• Provide with a sample code (HelloController) or Test that reproduces the problem opendoc-example.zip

Expected behavior

• isX: Boolean should be documented as isX in the API-docs (refer to Test1 in opendoc-example.zip)
• SnakeCaseStrategy Jackson 3 should be read and used in the API-docs (refer to Test2 in opendoc-example.zip)
• @param:Schema should be used in the API-docs (refer to Test3 in opendoc-example.zip)

[Mattias-Sehlstedt]

isX becoming x is a feature from swagger-core when it introspects models.

Jackson 3 is not used as described in #3169 (comment), which I assume is the cause for why it does not affect the result.

[nico-arianto]

🗒️ How about the omission of the @Schema annotation?

Reason: I tried to overcome it with @param:Schema(name = "..."), but it's been ignored

[nico-arianto]

Q: isX becoming x, is there a config to disable this feature?

[Mattias-Sehlstedt]

Q: isX becoming x, is there a config to disable this feature?

Not as far as I am aware. See this comment for a reference to a swagger-core issue, as well as a potential workaround.

[Mattias-Sehlstedt]

🗒️ How about the omission of the @Schema annotation?

Reason: I tried to overcome it with @param:Schema(name = "..."), but it's been ignored

I have not worked with how models are introspected for kotlin, so I am unable to assist with it. I also see that the workaround is tied to this, so might be that that cannot be applied.

[nico-arianto]

Q: isX becoming x, is there a config to disable this feature?

Not as far as I am aware. See this comment for a reference to a swagger-core issue, as well as a potential workaround.

🗒️ but that workaround didn't works in my case, because the @Schema is been ignored

[nico-arianto]

Info: these issues only happen since upgrade the Spring Doc to 3.0.0 in Spring Boot 4.0.0, in previous version 2.x, it's working correctly.

Note: At least the @Schema is not been ignored 😅