ItemController中GET请求触发405 Method Not Allowed错误的排查求助

你遇到的405错误和路由歧义问题，核心原因是混淆了「路径参数」和「查询参数」的写法，同时多个Action的路由模板发生了冲突。

你的需求是通过item/query?barcode=xxx这类查询参数（URL中?后的键值对）过滤商品，但你写的[HttpGet("query/{barcode:int}")]是路径参数的写法（对应URL为item/query/123），这完全不符合你的预期。另外，query/{name}和query/{category}都是字符串类型的路径参数，ASP.NET Core无法区分请求该匹配哪个Action，最终导致路由匹配失败，返回405错误。

下面给出两种解决方案，推荐第一种更符合RESTful风格的实现：

推荐方案：单Action处理多查询参数 #

这种方式既满足你的查询参数需求，又避免了路由歧义，还支持多条件组合查询（比如item/query?category=electronics&discount=10）：

using InventoryWebApi.DataAccess;
using InventoryWebApi.DTO;
using InventoryWebApi.Models;
using Microsoft.AspNetCore.Mvc;
using System;
using System.Linq;
using System.Threading.Tasks;
using Microsoft.EntityFrameworkCore; // 如果使用EF Core需要添加这个命名空间

namespace InventoryWebApi.Controllers {
    [ApiController]
    [Route("[controller]")]
    public class ItemController : ControllerBase {
        private readonly IRepository repository;
        public ItemController(IRepository repository) {
            this.repository = repository;
        }

        [HttpGet("query")]
        public async Task<IActionResult> GetItems(
            [FromQuery] int? barcode, 
            [FromQuery] int? discount, 
            [FromQuery] string name, 
            [FromQuery] string category) 
        {
            IQueryable<Item> query = repository.Items;

            // 根据传入的查询参数逐步过滤
            if (barcode.HasValue) {
                query = query.Where(i => i.Barcode == barcode.Value);
            }
            if (discount.HasValue) {
                query = query.Where(i => i.Discount == discount.Value);
            }
            if (!string.IsNullOrEmpty(name)) {
                query = query.Where(i => i.Name.Contains(name)); // 可根据需求改为Equals
            }
            if (!string.IsNullOrEmpty(category)) {
                query = query.Where(i => i.Category == category);
            }

            var items = await query.ToListAsync();
            return Ok(items);
        }
    }
}

备选方案：拆分多个Action（不推荐） #

如果你坚持要拆分多个Action，需要给每个Action设置唯一的路由前缀来避免歧义，但这种方式不符合查询参数的使用习惯（访问路径会变成item/query/barcode/123而非item/query?barcode=123）：

[ApiController]
[Route("[controller]")]
public class ItemController : ControllerBase {
    private readonly IRepository repository;
    public ItemController(IRepository repository) {
        this.repository = repository;
    }

    [HttpGet("query/barcode/{barcode:int}")]
    public async Task<IActionResult> GetByBarcode(int barcode) {
        var item = await repository.Items.FirstOrDefaultAsync(i => i.Barcode == barcode);
        return Ok(item);
    }

    [HttpGet("query/discount/{discount:int}")]
    public async Task<IActionResult> GetByDiscount(int discount) {
        var items = await repository.Items.Where(i => i.Discount == discount).ToListAsync();
        return Ok(items);
    }

    [HttpGet("query/name/{name}")]
    public async Task<IActionResult> GetByName(string name) {
        var items = await repository.Items.Where(i => i.Name.Contains(name)).ToListAsync();
        return Ok(items);
    }

    [HttpGet("query/category/{category}")]
    public async Task<IActionResult> GetByCategory(string category) {
        var items = await repository.Items.Where(i => i.Category == category).ToListAsync();
        return Ok(items);
    }
}

关键知识点总结 #

• 查询参数：用[FromQuery]标记，对应URL中?后的键值对，适合可选的过滤条件。
• 路径参数：放在路由模板的{}中，对应URL路径的一部分，适合必填的资源标识（比如item/123获取单个商品）。
• 路由歧义：当多个Action的路由模板无法被ASP.NET Core区分时（比如两个都是字符串类型的路径参数），会导致路由匹配失败，返回405或404错误。

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