Documenting multipart/form-data JAX-RS endpoint triggers jersey validation error

[zsoltherpai]

I use jersey (2.27) and implemented a file upload using multipart/form-data. I use swagger jax-rs2 (2.0.5) to document it.

The documentation of InputStream and FormDataBodyPart reveals the objects internals by default, so I used @parameter to override the schema, eg:
@parameter(schema = @Schema(type = "string", format = "binary", description = "blob"))

This triggers a validation error at jersey start on either InputStream or FormDataBodyPart parameter:
[[FATAL] No injection source found for a parameter of type ....
Very weirdly the issue is not completely deterministic, but a few clean / builds / test trigger it.

If I remove the @parameter(schema = ...) annotation, jersey initialization is solid again. Apparently swagger's @parameter annotation interferes with Jersey.

As a workaround I annotated the parameters with @parameter(hidden = true) and documented the parameters in the @operation annotation, that doesn't seem to cause any issues.

[frantuma]

This is possibly similar to #2567 and is probably not related to swagger, but related to this jersey issue and can be worked around by having FormDataParam as the last annotation.
Please give it a go, and close ticket if it solves your issue

[zsoltherpai]

I've always had @FormDataParam as the last annotation - although only accidentally through a convention of doc annotations first..

But a similar jersey bug might be the culprit. I keep my workaround for a while and keep an eye on the related jersey issues, thanks.