如何移除Swagger模型文档中的末尾逗号？（Swashbuckle+C#）

既然你已经确认逗号是Swagger UI在前端渲染环节自动添加的，后端的OperationFilter确实无法干预这个层面的内容——毕竟这类Filter只负责修改OpenAPI规范本身，管不到前端的渲染逻辑。那咱们就从前端入手，通过注入自定义脚本的方式来解决这个问题。

方法1：注入自定义JavaScript修正DOM内容 #

步骤1：配置Swagger UI加载自定义脚本 #

在项目的Configure方法里（.NET 6+是在Program.cs，旧版本在Startup.cs），修改Swagger UI的配置，加入脚本注入：

app.UseSwaggerUI(c =>
{
    c.SwaggerEndpoint("/swagger/v1/swagger.json", "你的API名称 V1");
    // 注入自定义脚本，路径要和后续创建的文件对应
    c.InjectJavascript("/swagger-ui/custom-swagger-fix.js");
});

步骤2：创建自定义脚本文件 #

在项目的wwwroot/swagger-ui目录下（没有就新建一个），创建custom-swagger-fix.js文件，写入以下代码：

// 等待Swagger UI完全加载完成
window.addEventListener('load', () => {
    // 定义移除末尾逗号的核心函数
    const trimTrailingCommas = () => {
        // 匹配模型属性描述的元素，根据你的Swagger UI版本调整选择器
        // 可以用浏览器开发者工具查看实际元素的类名
        const descriptionElements = document.querySelectorAll('.prop-description, .model-description');
        
        descriptionElements.forEach(element => {
            const rawText = element.textContent.trim();
            if (rawText.endsWith(',')) {
                element.textContent = rawText.slice(0, -1).trim();
            }
        });
    };

    // 首次加载时执行一次
    trimTrailingCommas();

    // 监听DOM变化，处理动态加载的内容（比如展开模型、切换API标签）
    const observer = new MutationObserver((mutations) => {
        mutations.forEach(mutation => {
            if (mutation.addedNodes.length > 0) {
                trimTrailingCommas();
            }
        });
    });

    // 监听Swagger UI的根容器
    const swaggerRoot = document.getElementById('swagger-ui');
    if (swaggerRoot) {
        observer.observe(swaggerRoot, { childList: true, subtree: true });
    }
});

注意事项 #

• 调整DOM选择器：不同版本的Swashbuckle对应的Swagger UI DOM结构可能有差异，如果脚本没生效，打开浏览器开发者工具找到属性描述的元素类名，替换querySelectorAll里的内容即可。
• 确保静态文件服务启用：项目里要已经配置了app.UseStaticFiles()，否则自定义脚本无法被加载。

备选思路：后端批量修正属性描述（如果逗号是自带的） #

如果你之前判断有误——逗号其实是后端模型属性的Description里自带的（比如[Description("用户名,")]），那可以用IModelFilter批量移除所有属性描述末尾的逗号，这种后端处理更彻底：

public class RemoveTrailingCommaFilter : IModelFilter
{
    public void Apply(OpenApiSchema schema, SchemaFilterContext context)
    {
        if (schema.Properties == null) return;
        
        foreach (var (_, property) in schema.Properties)
        {
            if (!string.IsNullOrEmpty(property.Description) && property.Description.Trim().EndsWith(','))
            {
                property.Description = property.Description.Trim().Substring(0, property.Description.Trim().Length - 1);
            }
        }
    }
}

然后在ConfigureServices里注册这个Filter：

services.AddSwaggerGen(c =>
{
    c.SwaggerDoc("v1", new OpenApiInfo { Title = "你的API", Version = "v1" });
    c.SchemaFilter<RemoveTrailingCommaFilter>();
});

内容的提问来源于stack exchange，提问作者Tom Kludy