asp-route标签助手无法正确生成包含指定路由参数的URL问题

问题排查与解决方案 #

按优先级逐一排查处理：

• 首先确认Model对应属性是否有有效值
  先在按钮附近加调试代码输出三个属性的值，确认不是null、空字符串，或者int类型的默认值0：

  <!-- 调试用，确认参数值是否存在 -->
  <div>SearchCriteria：@Model.SearchCriteria，OrderBy：@Model.OrderBy，PageNumber：@Model.PageNumber</div>
  

  ASP.NET Core的标签助手默认会自动省略值为null、空字符串，或者值匹配路由定义中对应参数默认值的字段，不会生成到查询字符串中。比如路由配置中pageNumber的默认值为1，而你的Model.PageNumber刚好是1，就会被自动省略。

• 检查路由配置是否存在冲突
  查看Program.cs（.NET 6+）或Startup.cs（.NET 5及更早）中的路由规则，确认没有和这三个参数重名的路由字段导致冲突，也没有配置特殊的路由过滤规则排除这三个参数。如果使用了区域路由，还要同步检查区域的路由配置。

• 兜底解决方案：手动构造formaction属性
  如果无法快速定位根因，可以放弃使用asp-route系列标签助手，直接通过Url.Action手动拼接地址，完全可控不会丢参数：

  <button id="@($"{stage}_{Model.PatientID}")"
          class="mdc-button mdc-button--raised mdc-button--touch @(actionBtnCssClass) rehabAction"
          data-stage="@(stage)"
          formaction="@Url.Action("Edit", "Question", new {
              stage = aspRouteParamStage,
              patientID = Model.PatientID,
              patientName = Model.PatientName,
              episodeID = Model.EpisodeID,
              searchCriteria = Model.SearchCriteria,
              orderBy = Model.OrderBy,
              pageNumber = Model.PageNumber
          })">
      <!-- 按钮内部内容省略 -->
  </button>
  

  另一个分支里指向Patient/Index的按钮也可以用同样的方法手动构造formaction。

• 额外排查项
  如果项目中存在自定义的Button标签助手、全局路由处理过滤器，会修改标签生成的URL逻辑，也可能导致参数被过滤，可以暂时注释相关自定义逻辑验证是否恢复正常。另外也要确认分部视图加载时是否传递了完整的Model对象，避免三个属性未被正确赋值。

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