如何将ASP.NET Core MVC控制器正确转换为API控制器？

下面针对你提供的MVC登录控制器，逐个替换MVC特有特性为API适配方案，并给出完整转换代码：

关键特性转换说明 #

• ModelState验证：MVC里返回View(loginUserDto)回显表单，API直接返回BadRequest(ModelState)，自动返回400状态码和验证错误的JSON结构，前端可直接解析展示。
• Redirect/RedirectToAction跳转：API不做服务端页面跳转，改为返回包含跳转地址的响应数据，由前端负责路由跳转；两步验证场景返回标识和必要参数，让前端引导用户进入两步验证流程。
• TempData/ViewData传值：这类视图专用的传值容器直接废弃，把需要传递的消息、returnUrl等数据封装到响应模型里返回给前端。

转换后的完整代码 #

第一步：定义统一响应DTO #

先创建登录响应模型，统一返回各种场景的结果：

public class LoginResponseDto
{
    public bool Succeeded { get; set; }
    public string Message { get; set; }
    public string RedirectUrl { get; set; }
    public bool RequiresTwoFactor { get; set; }
    public TwoFactorParamsDto TwoFactorParams { get; set; }
}

public class TwoFactorParamsDto
{
    public string UserName { get; set; }
    public bool RememberMe { get; set; }
    public string ReturnUrl { get; set; }
    public bool SendCode { get; set; }
}

第二步：改写为API控制器方法 #

[ApiController]
[Route("api/account")]
[AllowAnonymous]
public class AccountApiController : ControllerBase
{
    private readonly IAccountService _accountService;

    public AccountApiController(IAccountService accountService)
    {
        _accountService = accountService;
    }

    [HttpPost("login")]
    public async Task<ActionResult<LoginResponseDto>> Login(LoginUserDto loginUserDto, string returnUrl)
    {
        if (!ModelState.IsValid)
        {
            return BadRequest(ModelState);
        }

        var rs = await _accountService.SignInAsync(loginUserDto);
        if (rs.Succeeded)
        {
            var redirectUrl = Url.IsLocalUrl(returnUrl) ? returnUrl : Url.Action("Index", "Home");
            return Ok(new LoginResponseDto
            {
                Succeeded = true,
                Message = $"Hello {loginUserDto.UserName}, Welcome back!",
                RedirectUrl = redirectUrl
            });
        }
        else if (rs.Data.RequiresTwoFactor)
        {
            return Ok(new LoginResponseDto
            {
                Succeeded = false,
                RequiresTwoFactor = true,
                TwoFactorParams = new TwoFactorParamsDto
                {
                    UserName = loginUserDto.UserName,
                    RememberMe = loginUserDto.RememberMe,
                    ReturnUrl = returnUrl,
                    SendCode = true
                }
            });
        }
        else if (rs.Data.IsLockedOut)
        {
            ModelState.AddModelError(string.Empty, "Account locked");
            return BadRequest(ModelState);
        }
        else
        {
            ModelState.AddModelError(string.Empty, "Invalid Login Attempt");
            return BadRequest(ModelState);
        }
    }
}

额外说明 #

• 控制器要加上[ApiController]特性，它会自动处理ModelState验证（如果验证失败会直接返回400，也可以保留手动判断逻辑更灵活）。
• 所有跳转逻辑交给前端，前端拿到RedirectUrl后自行处理页面跳转；两步验证场景拿到RequiresTwoFactor和TwoFactorParams后，引导用户进入两步验证的前端页面。
• 原MVC里的弹窗脚本直接换成返回文字消息，由前端自行实现弹窗逻辑（比如用swal展示返回的Message）。

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