Upgrading Swashbuckle.AspNetCore 2 to 3
Breaking2.5.0 → 3.0.0Breaking2New1Changed1
BreakingUpgrade verdict
2 breaking changes.
In plain terms
- If you use Swagger annotations like SwaggerOperation or SwaggerResponse, you now need to install a separate package and turn it on.
- Marking a parameter or property with Required or BindRequired now always makes it required in the generated Swagger, even if it is not nullable.
Must act 2 items need code or config changes
What you must change
Breaking2
Swagger-specific annotations move to the new Swashbuckle.AspNetCore.Annotations package, which must be installed and enabled explicitly.
Swashbuckle.AspNetCore.AnnotationsSwaggerGenAnnotationsSwaggerOperationSwaggerResponseRequired and BindRequired attributes are now honored on all parameters and model properties, not only nullable ones.
RequiredBindRequired