集成测试启动时，中间件GetEndpoint返回405 HTTP方法不支持

问题描述 #

使用ASP.NET Minimal API时，生产环境启动运行正常，但通过集成测试复用Program类时，自定义认证中间件内的一个Post端点返回405错误，同一控制器内其他端点可正常访问。具体配置如下：

1. 在Program.cs末尾添加部分类以允许测试项目访问：

public partial class Program { }

2. 创建测试工厂类：

internal class ProductionWebApiTesterFactory : WebApplicationFactory<Program> {}

3. 测试中创建客户端：

await using var factory = new ProductionWebApiTesterFactory();
using HttpClient client = factory.CreateDefaultClient();

4. 出现问题的控制器代码：

[Route("is-pfd/api/viewer")]
[ApiController]
[AllowAnonymous]
public class DocuViewareController : ControllerBase
{
    // 返回405的端点
    [HttpPost("baserequest")]
    public string baserequest([FromBody] object jsonString)
    {
        return DocuViewareControllerActionsHandler.baserequest(jsonString);
    }

    // 正常工作的端点
    [HttpGet("getresource")]
    public IActionResult GetResource(string resourceID, string version)
    {
        DocuViewareControllerActionsHandler.getresource(resourceID, version, out HttpStatusCode statusCode, out byte[] content, out string contentType, out string fileName, out string reasonPhrase);
        if (statusCode == HttpStatusCode.OK)
        {
            return File(content, contentType, fileName);
        }
        else
        {
            return StatusCode((int)statusCode, reasonPhrase);
        }
    }
    ///...
}

解决思路 #

• 核对测试请求的基本信息：确认测试代码中请求的HTTP方法是POST，URL路径完全匹配/is-pfd/api/viewer/baserequest，无大小写错误或路径拼接问题。同时检查请求的Content-Type是否设置为application/json，[FromBody]依赖正确的媒体类型完成模型绑定，类型不匹配可能导致路由匹配失败返回405。
• 检查路由冲突：排查Program.cs中是否定义了同名的Minimal API端点（比如app.MapPost("/is-pfd/api/viewer/baserequest", ...)），这类端点会优先于控制器路由注册，导致控制器的Post端点无法被匹配。
• 验证自定义认证中间件逻辑：查看中间件在测试环境中的行为，是否对POST请求做了额外的方法校验或拦截，比如误将POST请求判定为不允许的方法，或者测试环境下中间件的依赖未正确初始化导致逻辑异常。
• 查看405响应的Allow头：捕获测试请求的响应头，查看Allow字段的值，确认该端点实际被注册的允许方法。如果Allow中没有POST，说明路由未正确注册；如果包含POST，则问题出在中间件或权限校验环节。
• 调整WebApplicationFactory配置：重写ProductionWebApiTesterFactory的ConfigureWebHost方法，确保测试环境的中间件注册顺序、路由配置与生产环境完全一致，避免测试环境遗漏必要的配置项。
• 检查控制器路由属性：确认[HttpPost("baserequest")]与类级别的[Route("is-pfd/api/viewer")]组合后的完整路由是否正确，无拼写错误或多余的路径片段。

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