.NET 6 Minimal API如何返回HTML/文本格式的403响应

问题根源是你误用了MVC体系的ContentResult，而Minimal API要求返回IResult接口的实现（由Results静态类提供），直接返回ContentResult会导致类型不匹配，触发CS0266和CS1662错误。

正确做法：使用Results.Content()方法 #

Results.Content()是Minimal API专门用来返回自定义内容（HTML/文本）的方法，能直接返回符合要求的IResult实例，同时支持指定状态码和内容类型。

示例代码对比 #

错误写法（触发编译错误）

app.MapGet("/file", async (HttpContext context) =>
{
    if (!CheckPermission())
    {
        // 错误：ContentResult不属于Minimal API的IResult体系
        return new ContentResult
        {
            Content = "<h1>403 禁止访问</h1>",
            ContentType = "text/html",
            StatusCode = 403
        };
    }
    // 文件/304逻辑...
});

正确写法（解决错误）

app.MapGet("/file", async (HttpContext context) =>
{
    if (!CheckPermission())
    {
        // 返回HTML格式的403响应
        return Results.Content(
            content: "<!DOCTYPE html><html><body><h1>403 禁止访问</h1><p>您没有权限访问此资源</p></body></html>",
            contentType: "text/html",
            statusCode: StatusCodes.Status403Forbidden
        );
    }

    // 处理304未修改逻辑
    var targetFile = new FileInfo("your-file-path");
    if (context.Request.Headers.TryGetValue("If-Modified-Since", out var modifiedHeader) &&
        DateTime.TryParse(modifiedHeader, out var clientModifiedDate) &&
        targetFile.LastWriteTimeUtc <= clientModifiedDate.ToUniversalTime())
    {
        return Results.StatusCode(StatusCodes.Status304NotModified);
    }

    // 返回文件
    return Results.File(targetFile.FullName, "application/octet-stream");
});

额外注意 #

如果你的端点逻辑没有异步操作，可以去掉async关键字，直接返回IResult，不用包裹Task：

app.MapGet("/file", (HttpContext context) =>
{
    if (!CheckPermission())
    {
        return Results.Content("<h1>403 禁止访问</h1>", "text/html", 403);
    }
    // 同步逻辑...
    return Results.File("your-file-path");
});

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