.NET Core动态路由配置引发404错误的排查与解决

为什么会出现404？ #

核心问题是返回类型不兼容ASP.NET Core框架：HttpResponseMessage是传统ASP.NET Web API的返回类型，ASP.NET Core的ControllerBase无法正确处理该类型，导致路由匹配后无法生成有效响应，最终触发404错误。

另外，第一个版本的方法参数中缺少路由参数sitename，虽然[ApiController]特性会自动绑定路由参数，但显式声明参数能避免潜在的绑定问题。

修复步骤 #

1. 替换返回类型为ASP.NET Core标准类型 #

将方法返回类型从Task<HttpResponseMessage>改为Task<IActionResult>（或具体的派生类型，如OkObjectResult、FileStreamResult等），这是ASP.NET Core API控制器的标准返回方式。

2. 确保路由参数正确绑定 #

显式声明sitename参数，让路由绑定更清晰，避免隐式绑定可能带来的问题。

修复后的完整代码 #

[ApiController]
[Route("wopi/{sitename}/[controller]")]
public class FilesController : ControllerBase
{
    public FilesController()
    {
    }

    [HttpGet("{guid}")]
    public async Task<IActionResult> CheckFileInfo(string sitename, string guid, string access_token, long access_token_ttl)
    {
        // 替换为你的业务逻辑，比如返回文件元数据
        var fileMetadata = new 
        { 
            SiteName = sitename,
            FileGuid = guid,
            ValidToken = !string.IsNullOrEmpty(access_token)
        };
        return Ok(fileMetadata);
    }

    [HttpGet("{guid}/contents")]
    public async Task<IActionResult> GetFile(string sitename, string guid, string access_token, long access_token_ttl)
    {
        // 替换为你的文件读取逻辑，比如返回文件流
        var sampleContent = "This is the file content for GUID: " + guid;
        return Content(sampleContent, "text/plain");
    }
}

额外验证项 #

• 确认Program.cs中已配置控制器路由：必须包含app.MapControllers();，否则API控制器的路由不会生效。
• 测试时可以先简化逻辑，比如直接返回Ok()，确认路由能正常匹配后再添加业务代码。

内容的提问来源于stack exchange，提问作者A. Gladkiy