ASP.NET Web API返回字符串无内容显示，如何修复？

云原生阿岚

2026-7-18

修复ASP.NET Web API接口返回内容在Postman中不显示的问题

问题原因

你的接口返回HttpResponseMessage但Postman只显示元数据，核心原因是控制器基类选择错误：如果控制器继承自MVC的Controller而非Web API的ApiController，框架会将HttpResponseMessage对象本身序列化为JSON返回，而非解析并返回其包含的Content内容。另外，直接返回HttpResponseMessage也并非ASP.NET Web API的推荐用法。

修复方案

方案1：确保控制器继承自ApiController

检查控制器基类，改为继承System.Web.Http.ApiController（而非System.Web.Mvc.Controller）：

public class RolesController : ApiController // 必须使用ApiController作为基类
{
    [HttpPost, Route("add_role")]
    public async Task<HttpResponseMessage> addRole(string roleName, string roleDescription)
    {
        var response = new HttpResponseMessage(HttpStatusCode.OK)
        {
            Content = new StringContent("some string", Encoding.UTF8, "text/html"),
        };
        return response;
    }
}

方案2：改用IHttpActionResult返回类型（推荐）

这是Web API的标准返回方式，框架会自动处理内容输出，写法更简洁：

[HttpPost, Route("add_role")]
public async Task<IHttpActionResult> addRole(string roleName, string roleDescription)
{
    // 返回指定格式的内容
    return Content(HttpStatusCode.OK, "some string", new MediaTypeHeaderValue("text/html"));
    // 若需返回JSON内容，直接使用：return Ok("some string");
}

方案3：若为MVC控制器（非Web API），调整返回类型

如果你的控制器是用于页面渲染的MVC控制器，但需要返回纯文本/HTML内容，改用ContentResult替代HttpResponseMessage：

[HttpPost, Route("add_role")]
public async Task<ContentResult> addRole(string roleName, string roleDescription)
{
    return Content("some string", "text/html", Encoding.UTF8);
}