ASP.NET CORE中HttpPost Ajax调用出现404错误求助

嘿，我之前也碰到过一模一样的问题——本地跑起来顺得不行，一部署到服务器就404，折腾了好一阵才搞定。结合你的情况，大概率是路由路径或者部署配置的问题，我给你梳理几个最常见的排查方向：

1. 先查Ajax的请求路径！这是最容易踩的坑 #

你没贴Ajax的JS代码，但我敢打赌这是最可能的原因。本地开发时应用跑在根目录（比如http://localhost:5000/），用绝对路径/Home/UploadFilesAjax没问题，但服务器部署后，很多时候应用会放在虚拟目录下（比如http://yourdomain.com/your-app/），这时候直接写绝对路径就会请求错误的地址，自然返回404。

解决办法很简单：别硬写路径，用ASP.NET的UrlHelper生成正确的路由地址。在View里先把路径存成变量：

<script>
// 用Url.Action自动生成匹配部署环境的路径
const uploadUrl = '@Url.Action("UploadFilesAjax", "Home")';

// 然后Ajax里用这个变量
$('#upload').click(function() {
    const formData = new FormData($('form')[0]);
    $.ajax({
        url: uploadUrl,
        type: 'POST',
        data: formData,
        processData: false,
        contentType: false,
        success: function(res) {
            // 处理成功逻辑
        },
        error: function(err) {
            console.log(err);
        }
    });
});
</script>

这样不管你部署在根目录还是子目录，生成的路径都是对的。

2. 检查Controller的路由配置 #

你的Action加了[HttpPost]，但要确认路由规则能匹配到它：

• 如果用的是传统路由（默认的那种），看看Program.cs里的路由模板是不是默认的：

app.MapControllerRoute(
    name: "default",
    pattern: "{controller=Home}/{action=Index}/{id?}");

如果你的Controller是HomeController，方法是UploadFilesAjax，这个模板是能匹配到的，但如果服务器上的路由配置被修改过（比如加了自定义路由前缀），就可能匹配失败。

• 如果用的是属性路由，要确保你的Action上有正确的[Route]标签，比如：

[HttpPost]
[Route("Home/UploadFilesAjax")] // 或者更简洁的[Route("UploadFilesAjax")]
public IActionResult UploadFilesAjax() {
    // 你的逻辑
}

3. 排查服务器的部署配置 #

有时候服务器的设置也会导致404：

• 确认应用部署的目录和站点绑定的路径一致，比如如果部署在子目录，站点的物理路径要指向子目录，或者在IIS里设置虚拟目录。
• 检查服务器的应用池版本，确保和你的项目.NET版本匹配（比如你用.NET 6，应用池就不能选.NET Framework）。

4. 看看是不是请求被拦截了 #

虽然404一般是路径问题，但有些服务器（比如IIS）的安全配置可能会拦截Multipart请求，不过这种情况大多返回400或500，但也可以排查下：
在web.config里加上文件上传的大小限制（如果是ASP.NET Core的话，也可以在Program.cs里配置）：

<!-- 针对ASP.NET Framework或兼容模式 -->
<system.web>
    <httpRuntime maxRequestLength="1048576" /> <!-- 1GB，单位KB -->
</system.web>
<system.webServer>
    <security>
        <requestFiltering>
            <requestLimits maxAllowedContentLength="1073741824" /> <!-- 1GB，单位字节 -->
        </requestFiltering>
    </security>
</system.webServer>

5. 开日志抓真实请求 #

如果上面都排查了还没解决，就去服务器上看请求日志：

• ASP.NET Core可以在Program.cs里开启详细日志，或者直接看服务器上的日志文件（比如IIS的日志在C:\inetpub\logs\LogFiles），找到那个404的请求记录，看看实际请求的URL是什么，对比一下应该就能发现问题。

要是能把你的Ajax代码贴出来，我能更精准地帮你定位，但先按上面的步骤排查，应该能解决问题！

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