You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

FastEndPoints Swagger端点分组名称小写问题求助

解决FastEndPoints Swagger分组名称"Roles"被自动小写的问题
  • 自定义Swagger分组命名策略
    FastEndPoints默认会对分组名称做小写转换,你可以通过配置SwaggerDocumentGeneratorOptions来禁用这个行为。在服务配置代码(如Program.cs)里添加:

    builder.Services.SwaggerDocument(o =>
    {
        o.DocumentSettings = s =>
        {
            s.GroupNameSelector = endpoint => endpoint.GroupName; // 直接使用端点配置的原始分组名,不做大小写转换
        };
    });
    

    配置后Swagger就会完整保留你设置的分组名称大小写,"Roles"部分不会被转小写。

  • 显式指定端点分组名的精确大小写
    在定义端点时,确保分组名的大小写符合你的需求,比如通过Group()方法或[Group]特性设置:

    public class RoleManagementEndpoint : Endpoint<RoleRequest, RoleResponse>
    {
        public override void Configure()
        {
            Post("/api/roles/manage");
            Group("SystemRolesAdmin"); // 这里的"Roles"保持大写
        }
    }
    

    配合上面的命名策略配置,就能完全保留分组名的原始格式。

  • 排查自定义代码对分组名的修改
    检查项目中是否存在自定义的Swagger过滤器、中间件,或者其他逻辑对分组名称做了ToLower()之类的统一转换,找到后移除或调整这部分代码即可。

内容的提问来源于stack exchange,提问作者manura

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.06.18 12:45:54