Orchard Core集成ASP.NET Core Web应用中Http Post请求返回Bad Request的问题咨询

看起来你遇到了Orchard Core集成Web API时的典型冲突问题——既要让Post接口正常工作，又不能破坏Orchard自带的Admin页面功能。我来帮你一步步解决这个问题：

问题根源分析 #

1. 未添加AddControllers()时Post请求失败：Orchard Core虽然内置了MVC基础，但没有自动注册API控制器所需的完整服务（比如模型绑定、[ApiController]特性支持），导致Post请求因缺少必要处理逻辑返回Bad Request。
2. 使用AddMvc()导致Admin页面异常：AddMvc()会注册完整的MVC视图服务，覆盖Orchard Core自定义的视图查找配置，使得Admin面板无法找到对应的Razor视图文件。
3. 端点冲突：直接添加AddControllers()后，API路由与Orchard自身的路由规则重叠，引发多端点匹配冲突。

正确解决方案 #

步骤1：调整控制器代码 #

给你的API控制器添加路由前缀和[ApiController]特性，隔离API路由与Orchard的路由：

// 替换成你的控制器名称
[Route("api/[controller]")]
[ApiController]
public class ApiController : ControllerBase
{
    [HttpPost("post")]
    public Task<string> Post()
    {
        return Task.FromResult("hiPost");
    }

    [HttpGet("get")]
    public Task<string> Get()
    {
        return Task.FromResult("hiGet");
    }
}

• [Route("api/[controller]")]：给所有API接口加上api/控制器名的前缀，避免和Orchard的admin等路由冲突。
• [ApiController]：启用API专属特性，自动处理模型验证、请求绑定等，解决Post请求的Bad Request问题。
• 继承ControllerBase而非Controller：只保留API所需的功能，避免引入视图相关的冗余逻辑。

步骤2：修改Startup.cs的服务配置 #

用AddControllers()替代AddMvc()，仅注册API控制器所需的服务，不干扰Orchard的视图系统：

public void ConfigureServices(IServiceCollection services)
{
    // 先注册Orchard Core核心服务
    services.AddOrchardCms();
    
    // 你的其他服务注册
    services.AddMediatR(typeof(SelectedWebSiteBlogQueryHandler).Assembly);
    services.AddAutoMapper(typeof(Startup));
    services.AddCors();
    
    // 仅添加API控制器服务，不包含视图相关组件
    services.AddControllers().AddNewtonsoftJson();
}

步骤3：调整请求管道配置 #

在UseOrchardCore()之前添加路由和API端点映射，确保API请求先被正确处理：

public void Configure(IApplicationBuilder app, IHostEnvironment env)
{
    if (env.IsDevelopment())
    {
        app.UseDeveloperExceptionPage();
    }

    app.UseCors(o => o.AllowAnyOrigin().AllowAnyHeader().AllowAnyMethod());
    app.UseHttpsRedirection();
    app.UseStaticFiles();

    // 启用路由中间件
    app.UseRouting();

    // 映射API控制器的端点
    app.UseEndpoints(endpoints =>
    {
        endpoints.MapControllers();
    });

    // 最后让Orchard处理自身的路由和请求
    app.UseOrchardCore();
}

验证效果 #

1. 启动项目后，用Postman访问POST https://localhost:<端口>/api/<控制器名>/post，应该能正常返回hiPost。
2. 访问Orchard Admin页面（默认/admin），应该能正常加载，不会再出现视图找不到的错误。

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