OrchardCore中MapDynamicControllerRoute路由返回404页面问题排查

1. 控制器注册是否符合OrchardCore模块规范 #

• 你的KeywordLocationController必须放在OrchardCore模块项目中，且模块已在后台启用。OrchardCore不会自动发现非模块项目内的控制器，还要检查模块的Manifest.cs是否正确配置，或者在模块Startup类里通过services.AddControllersWithViews().AddApplicationPart(typeof(KeywordLocationController).Assembly)手动注册控制器所在的程序集。
• 对比HomeRouteTransformer的逻辑，Home相关控制器是OrchardCore核心模块自带的，已经完成了注册绑定，自定义控制器很可能遗漏了模块内的注册步骤。

2. 路由转换器返回的路由值是否正确 #

• 检查KeywordLocationTransformer的TransformAsync方法，返回的路由字典里必须包含controller和action键，值要和你的控制器、Action严格对应：比如控制器是KeywordLocationController，controller值就得是KeywordLocation；Action是Index的话，action值就是Index，拼写、大小写都不能出错。
• 可以在转换器里加日志输出实际返回的路由值，比如：

  _logger.LogInformation("转换后的路由值：{Values}", JsonSerializer.Serialize(values));
  

  确认输出内容是否和预期一致。

3. 路由注册的优先级与位置是否正确 #

• OrchardCore路由有优先级规则，你的动态路由要注册在其他可能抢先匹配的路由前面，比如在UseEndpoints里先注册自定义动态路由，再调用MapOrchardCore()：

  app.UseEndpoints(endpoints =>
  {
      endpoints.MapDynamicControllerRoute<KeywordLocationTransformer>("{prefix}/{keyword}/{location}");
      endpoints.MapOrchardCore();
  });
  

• 如果你的URL前缀what-do-we-do刚好和某个内容项的路由冲突，OrchardCore的内容路由会优先匹配，导致自定义控制器无法命中请求。

4. 控制器Action的权限与参数绑定是否正常 #

• 检查Action方法有没有添加[AllowAnonymous]特性，OrchardCore默认会给控制器应用授权策略，虽然这一般导致401错误，但也有可能间接引发404（比如授权失败后跳转的页面不存在）。
• 确保Action的参数和路由值匹配，比如Action需要prefix、keyword、location参数，要么参数名和路由键完全一致，要么用[FromRoute]特性明确绑定。

5. 模块是否设置了路由前缀 #

• 如果你的模块配置了路由前缀（比如在Startup里添加了AddRazorPagesOptions(options => options.Conventions.AddAreaPageRoute("YourModule", "", "{*url}"))），那访问自定义路由时必须带上模块前缀，而你的示例URL未包含前缀，自然会返回404。

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