ASP.NET Core 8 Minimal API发布后Swagger无端点显示求助

核心原因：Release模式下默认禁用端点元数据生成 #

.NET 8中，AddEndpointsApiExplorer在Release发布模式下默认不会生成端点元数据（Swagger依赖这些元数据展示接口），本地开发通常使用Debug模式，因此一切正常，发布后就会出现Swagger无端点的情况。

解决步骤 #

1. 强制启用端点元数据生成 #

修改Program.cs中AddEndpointsApiExplorer的注册代码，显式开启元数据生成：

builder.Services.AddEndpointsApiExplorer(options =>
{
    options.Enabled = true;
});

2. 确保Swagger在目标环境中启用 #

如果部署环境不是Development，可明确指定Swagger中间件的启用范围（按需调整环境判断逻辑）：

// 示例：允许在开发和生产环境启用Swagger
if (app.Environment.IsDevelopment() || app.Environment.IsProduction())
{
    app.UseSwagger();
    app.UseSwaggerUI(c =>
    {
        c.SwaggerEndpoint("/swagger/v1/swagger.json", "My API V1");
    });
}

3. 验证发布配置 #

• 确认发布时选择的目标框架与本地一致（如.NET 8）
• 检查发布后的appsettings.json或环境变量，确保没有覆盖Swagger相关配置

额外验证方式 #

发布后直接访问/swagger/v1/swagger.json，若返回包含paths节点的JSON数据，说明元数据生成正常，Swagger UI即可正确加载端点；若paths为空，需重新检查第一步的配置。

内容的提问来源于stack exchange，提问作者Zeel Gabriels