ABP v10.1 upgraded Swashbuckle.AspNetCore to v10, which pulls in Microsoft.OpenApi v2.x — a breaking change for any app with custom Swagger filters, schema customizations, or security requirements.

Changes

• Added "Swashbuckle.AspNetCore Upgraded to v10" section to the v10.1 migration guide under the Open-Source (Framework) heading.

Documented required migration actions:

• Add using Microsoft.OpenApi; — interfaces (e.g. IOpenApiSchema) moved there; concrete types (e.g. OpenApiSchema) stay in Microsoft.OpenApi.Models
• Update filter signatures to use interfaces; cast to concrete type to mutate properties:

  public void Apply(IOpenApiSchema schema, SchemaFilterContext context)
  {
      if (schema is OpenApiSchema openApiSchema)
          openApiSchema.Type = JsonSchemaType.String;
  }

• Replace string-based OpenApiSchema.Type with JsonSchemaType flags enum
• Replace OpenApiSchema.Nullable with schema.Type |= JsonSchemaType.Null
• Update .Reference properties to new *Reference classes (e.g. OpenApiSchemaReference)
• Update AddSecurityRequirement() to accept Func<OpenApiDocument, OpenApiSecurityRequirement>
• Links to the official Swashbuckle v10 migration guide for the full list of changes

Checklist

• I fully tested it as developer / designer and created unit / integration tests
• I documented it (or no need to document or I will create a separate documentation issue)

🔒 GitHub Advanced Security automatically protects Copilot coding agent pull requests. You can protect all pull requests by enabling Advanced Security for your repositories. Learn more about Advanced Security.