System.InvalidOperationException:“Action 'Tc.Controllers.Controllers.TestController.Get (Tc.Controllers)' does not have an attribute route. Action methods on controllers annotated with ApiControllerAttribute must be attribute routed.”

<think>好的，用户的问题是关于解决在C#中遇到的System.InvalidOperationException异常，具体是ApiControllerAttribute必须使用属性路由的问题。我需要先理解这个异常出现的原因，然后找到解决方案。 首先，用户提到的是ApiControllerAttribute必须使用属性路由，这可能是因为在ASP.NET Core中，当使用[ApiController]特性时，默认要求控制器使用属性路由而不是传统路由。如果用户没有正确配置路由属性，就会触发这个异常。 接下来，我需要回忆ASP.NET Core的路由机制。传统上，可以在Startup.cs中配置UseMvc或UseEndpoints来定义基于约定的路由，比如： app.UseEndpoints(endpoints => { endpoints.MapControllerRoute( name: "default", pattern: "{controller=Home}/{action=Index}/{id?}"); }); 但是，当控制器标记了[ApiController]特性时，框架会强制要求使用属性路由，也就是在控制器或动作方法上添加[Route]属性。如果用户没有这样做，就会导致异常。 解决方案可能包括两种方法：一种是按照要求添加属性路由，另一种是更改配置以允许传统路由。不过，根据ASP.NET Core的文档，从版本2.2开始，[ApiController]特性会自动要求属性路由，所以可能需要用户显式地添加路由属性。 例如，在控制器类上添加[Route("api/[controller]")]，或者在每个动作方法上指定具体的路由模板。如果用户希望禁用这个强制要求，可能需要通过配置来关闭这个行为，比如在Startup.cs的ConfigureServices中设置： services.AddControllers().ConfigureApiBehaviorOptions(options => { options.SuppressUseValidationProblemDetailsForInvalidModelStateResponses = true; }); 不过，这可能不会直接解决路由问题，正确的做法应该是指导用户正确使用属性路由。 另外，用户提供的引用中有关于其他InvalidOperationException的解决方法，比如线程访问控件、数据库连接未关闭等，但这些可能与当前问题无关，需要专注于路由配置的问题。 还需要考虑用户可能的代码结构，比如他们的控制器是否继承自ControllerBase，是否正确应用了路由属性。例如，正确的控制器应该像这样： [ApiController] [Route("api/[controller]")] public class MyController : ControllerBase { [HttpGet] public IActionResult Get() { // 方法实现 } } 如果用户没有添加[Route]属性，就会触发异常。 总结解决方案步骤： 1. 在控制器类上添加[Route]属性。 2. 或者在Startup中配置允许传统路由（可能需要调整兼容性设置）。 3. 检查是否所有API控制器都正确应用了属性路由。 同时，需要验证用户的代码示例，确保他们正确使用了属性路由，并指导如何修改。此外，可能需要提及ASP.NET Core版本差异，因为不同版本可能有不同的默认行为，但用户可能没有说明具体版本，所以假设是最新版本的处理方式。 最后，生成相关问题时要围绕属性路由的使用、异常处理、配置选项等方面展开，帮助用户进一步理解可能遇到的类似问题。</think>### 解决 `System.InvalidOperationException: ApiControllerAttribute 必须使用属性路由` 的问题 在 ASP.NET Core 中，当控制器标记了 `[ApiController]` 特性时，默认要求使用属性路由（Attribute Routing）而非传统路由（Conventional Routing）。若未正确配置路由属性，会触发以下异常： ``` System.InvalidOperationException: Action 'XXX' 未使用属性路由，因此无法与 ApiControllerAttribute 结合使用。 ``` #### 原因分析 1. **强制属性路由机制** ASP.NET Core 从 2.2 版本开始，`[ApiController]` 特性会强制控制器使用属性路由[^1]。若未在控制器或方法上定义 `[Route]` 或 `[HttpXXX]` 属性，框架会拒绝请求并抛出异常。 2. **与传统路由冲突** 若在 `Startup.cs` 中配置了传统路由（如 `endpoints.MapControllerRoute`），但未在控制器中显式声明属性路由，会导致路由冲突。 --- ### 解决方案 #### 方法 1：为控制器添加属性路由 在控制器类或方法上明确使用 `[Route]` 或 `[HttpXXX]` 属性： ```csharp [ApiController] [Route("api/[controller]")] // 控制器级路由属性 public class UserController : ControllerBase { [HttpGet("list")] // 方法级路由属性 public IActionResult GetUsers() { // 方法实现 } } ``` #### 方法 2：兼容传统路由（不推荐） 若需临时允许传统路由，可关闭 `[ApiController]` 的强制属性路由验证： ```csharp services.AddControllers() .ConfigureApiBehaviorOptions(options => { options.SuppressUseValidationProblemDetailsForInvalidModelStateResponses = true; options.SuppressInferBindingSourcesForParameters = true; options.SuppressMapClientErrors = true; }); ``` **注意**：此方法可能导致 API 设计不符合 RESTful 规范，建议优先使用属性路由。 --- ### 代码验证示例 错误配置（触发异常）： ```csharp [ApiController] public class UserController : ControllerBase { public IActionResult GetUsers() // 缺少 [Route] 或 [HttpGet] { return Ok(); } } ``` 正确配置（解决问题）： ```csharp [ApiController] [Route("api/[controller]")] public class UserController : ControllerBase { [HttpGet("list")] public IActionResult GetUsers() { return Ok(); } } ``` ---