如何在ASP.NET Core控制器方法中添加子路由？

核心错误原因 #

你的问题出在路由参数名称与方法参数名称不匹配：

• 路由模板里定义的是{id}，但方法接收的参数是courseId
• ASP.NET Core的模型绑定会根据名称匹配路由参数，找不到对应名称的参数时就会抛出"courseId字段必填"的400错误

错误写法分析 #

错误1：重复添加Route属性 #

同时给方法加[HttpGet("{id}")]和[Route("api/[controller]/{id}/course_subjects/")]会导致路由冲突，Swagger无法正确识别路由规则，访问时也会出现无响应问题。

错误2：路由参数与方法参数不匹配 #

直接修改HttpGet为[HttpGet("{id}/course_subjects")]时，路由参数是id，但方法参数是courseId，绑定失败导致400错误。

正确实现方式 #

方式一：修改路由参数名称匹配方法参数 #

把路由模板里的{id}改成{courseId}，让参数名称一致：

[Route("api/[controller]")]
[ApiController]
public class CourseController : ControllerBase
{
    // 正确的子路由写法
    [HttpGet("{courseId}/course_subjects")]
    public async Task<IEnumerable<SubjectDto>> GetCourseSubjectsList(string courseId)
    {
        return await _courseProcessor.GetSubjectsForCourseAsync(courseId);
    }
}

此时访问路由api/Course/123/course_subjects，路由中的123会自动绑定到courseId参数。

方式二：用[FromRoute]显式指定参数来源 #

如果不想修改路由参数名称，可以用[FromRoute]特性指定参数来自路由，并对应到id：

[Route("api/[controller]")]
[ApiController]
public class CourseController : ControllerBase
{
    [HttpGet("{id}/course_subjects")]
    public async Task<IEnumerable<SubjectDto>> GetCourseSubjectsList([FromRoute(Name = "id")] string courseId)
    {
        return await _courseProcessor.GetSubjectsForCourseAsync(courseId);
    }
}

这种方式明确告诉框架：从路由的id参数取值，绑定到方法的courseId参数上。

额外注意事项 #

• 不要同时给方法添加[HttpGet]和[Route]属性，避免路由规则冲突
• [ApiController]特性会自动启用路由模型绑定验证，参数不匹配直接返回400错误，这是你看到错误的原因

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