ASP.NET Core MVC添加POST处理程序遇404及最简实现方案

首先明确：ASP.NET Core 完全不兼容传统ASP.NET的ASHX（一般处理程序）和ASPX（Web窗体）。wwwroot目录仅用于存放静态资源，只有HTML、CSS、JS这类纯静态文件会被静态文件中间件直接返回，动态的ASPX/ASHX不会被解析执行，因此即使文件存在也会返回404。

针对你的需求，以下是几种最简实现方式：

1. 基于MVC控制器Action（贴合现有MVC架构） #

如果你的项目已经是MVC架构，优先用这种方式，只需确保控制器和Action的路由、特性配置正确：

// 控制器类必须以Controller结尾
public class PayController : Controller
{
    // 特性路由指定完整URL路径，适配你的部署子目录
    [HttpPost]
    [Route("UCSD-PACE2/Pay/Final")]
    public IActionResult Final()
    {
        // 处理POST请求逻辑：读取表单数据、请求体等
        var formData = Request.Form;
        // 返回响应，可根据需求返回JSON、视图或其他结果
        return Ok(new { Success = true, Message = "请求已处理" });
    }
}

注意事项： #

• 确保Program.cs中已配置MVC路由：

  // 启用控制器路由
  app.MapControllers();
  // 或默认MVC路由
  app.MapControllerRoute(
      name: "default",
      pattern: "{controller=Home}/{action=Index}/{id?}");
  

• 控制器类名必须以Controller后缀结尾（如PayController），否则框架无法识别。

2. 最小API（轻量无控制器） #

如果不需要MVC的视图、模型绑定等复杂功能，最小API是最简洁的选择，直接在Program.cs中定义POST端点：

// 直接映射POST路由和处理逻辑
app.MapPost("/UCSD-PACE2/Pay/Final", async (HttpContext context) =>
{
    // 读取请求体（如果是JSON格式，可直接绑定到模型）
    var requestModel = await context.Request.ReadFromJsonAsync<YourRequestModel>();
    
    // 执行处理逻辑
    // ...
    
    // 返回响应
    return Results.Ok(new { Status = "Success", Data = requestModel });
});

这种方式无需创建控制器文件，代码量极少，适合简单的POST请求处理。

排查之前控制器404的原因 #

你之前添加控制器方法返回404，大概率是以下问题：

• 控制器类未加Controller后缀
• Action未添加[HttpPost]特性（默认只接受GET请求）
• 路由配置错误，未适配部署的子目录UCSD-PACE2

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