Swashbuckle CustomSchemaIds未作用于swagger.json与Swagger UI生成

CustomSchemaIds 配置的委托未被调用，核心原因按出现概率从高到低排列如下：

• 无自定义业务类型触发回调：Swashbuckle 的 CustomSchemaIds 回调只会在生成用户自定义的非系统类型（自己定义的DTO、实体类等业务类型）的Schema时触发。如果你的所有接口入参、返回值都是系统内置的简单类型（int、string、DateTime等）、系统内置集合（如List<string>）、框架自带类型（如ProblemDetails、ValidationProblemDetails），Swashbuckle会直接使用内置规则生成这类系统类型的SchemaId，完全不会执行你配置的自定义委托。即使Swagger UI底部能看到Schema列表，只要这些Schema全是系统内置类型，就不会触发回调。
• 配置被后续操作覆盖：如果在AddSwaggerGen调用之后，你又通过Configure<SwaggerGeneratorOptions>、第三方Swagger增强插件（比如文档分组、注释增强类的包）修改了Swagger生成配置，很可能会把你之前设置的CustomSchemaIds委托覆盖为默认值，导致自定义逻辑不生效。
• Swagger文档来源不匹配：如果你同时启用了.NET原生OpenAPI（AddOpenApi）、NSwag等其他OpenAPI生成组件，且Swagger UI实际加载的是其他组件生成的OpenAPI文档，你针对Swashbuckle配置的CustomSchemaIds自然不会生效。
• 版本兼容Bug：Swashbuckle.AspNetCore 6.0~6.2区间的部分版本，在搭配NewtonsoftJson替代System.Text.Json序列化时，存在CustomSchemaIds回调不触发的已知问题，升级到最新稳定版即可修复。
• 缓存导致逻辑未执行：如果开启了Swagger文档缓存，Schema会在首次请求时生成后被缓存，后续请求直接返回缓存结果。如果是应用启动完成、Schema生成结束后才附加调试器，会出现断点不命中的情况；如果用了dotnet热重载，修改配置后没有完全重启应用，也会出现配置不生效的问题。

你可以按以下步骤快速定位问题：

1. 新建一个测试用的自定义DTO类：

public class TestDemoDto
{
    public int Id { get; set; }
    public string Name { get; set; }
}

2. 在任意公开控制器中添加一个使用该DTO作为返回值的接口：

[HttpGet("test-demo")]
public ActionResult<TestDemoDto> GetTestDemo()
{
    return new TestDemoDto();
}

3. 完全停止应用，关闭浏览器Swagger页面，重新以Debug模式启动应用，首次访问Swagger页面查看断点是否命中。
   • 如果断点命中，说明之前的问题是接口中没有自定义业务类型触发回调，配置本身是正常的。
   • 如果断点仍不命中，检查是否有其他配置/第三方组件覆盖了SwaggerGen配置，或者当前Swagger文档不是Swashbuckle生成的。

内容的提问来源于stack exchange，提问作者Tim Bassett