使用AspNet.FriendlyUrls自定义搜索友好URL的实现求助

问题分析 #

你之前的尝试存在三个核心问题：

1. 路由模板未包含search/前缀，无法匹配目标URL格式
2. 硬编码固定参数值，只能适配单一搜索场景，不具备通用性
3. 路由注册顺序错误，自定义路由需优先于FriendlyUrls注册（路由匹配按注册顺序执行）

步骤1：修正路由配置 #

修改RouteConfig类，先注册自定义搜索路由，再启用FriendlyUrls：

public static class RouteConfig
{
    public static void RegisterRoutes(RouteCollection routes)
    {
        // 注册通用搜索友好路由，优先级高于FriendlyUrls
        routes.MapPageRoute(
            routeName: "SearchFriendly",
            routeUrl: "search/{friendlySearchTerm}",
            physicalFile: "~/find" // 依赖FriendlyUrls移除.aspx后缀，直接写文件名
        );

        var settings = new FriendlyUrlSettings();
        settings.AutoRedirectMode = RedirectMode.Permanent;
        routes.EnableFriendlyUrls(settings, new WebMethodFriendlyUrlResolver());
    }

    public class WebMethodFriendlyUrlResolver : WebFormsFriendlyUrlResolver
    {
        public override string ConvertToFriendlyUrl(string path)
        {
            if (HttpContext.Current.Request.PathInfo != string.Empty)
            {
                return path;
            }
            else
            {
                return base.ConvertToFriendlyUrl(path);
            }
        }
    }
}

步骤2：生成友好URL（搜索提交时） #

在搜索提交页面（如搜索表单所在页面），将原始参数转换为友好格式并生成路由URL：

// 获取用户提交的搜索参数
string job = Request.Form["job"]?.Trim() ?? "";
string state = "CAIRO"; // 固定值可直接写死
string city = Request.Form["city"]?.Trim() ?? "";

// 生成标准化友好搜索词（小写、空格转连字符、用-in-连接）
string friendlyTerm = $"{job.ToLower()}-in-{city.Replace(" ", "-").ToLower()}";

// 通过路由系统生成友好URL
var routeValues = new RouteValueDictionary { { "friendlySearchTerm", friendlyTerm } };
string friendlyUrl = RouteTable.Routes.GetVirtualPath(null, "SearchFriendly", routeValues).VirtualPath;

// 重定向到友好URL
Response.Redirect(friendlyUrl);

步骤3：解析友好URL（在find页面处理） #

在find.aspx的Page_Load方法中，解析友好URL参数并还原为搜索逻辑所需的原始参数：

protected void Page_Load(object sender, EventArgs e)
{
    if (RouteData.Values.TryGetValue("friendlySearchTerm", out object termObj) && termObj is string friendlyTerm)
    {
        // 拆分友好词，还原原始搜索参数
        string[] parts = friendlyTerm.Split(new[] { "-in-" }, StringSplitOptions.RemoveEmptyEntries);
        if (parts.Length == 2)
        {
            string job = parts[0].Replace("-", " ").Trim();
            string city = parts[1].Replace("-", " ").Trim();
            string state = "CAIRO";

            // 直接使用job、city、state执行搜索逻辑
            // 示例：绑定搜索结果到控件
            // SearchResults.DataSource = GetSearchResults(job, city, state);
            // SearchResults.DataBind();
        }
    }
    else
    {
        // 兼容旧的带参数URL，并重定向到友好URL（可选，避免重复内容）
        string syxParam = Request.QueryString["Syx"];
        if (!string.IsNullOrEmpty(syxParam))
        {
            // 解析Syx参数为键值对
            var paramDict = new Dictionary<string, string>();
            foreach (string part in syxParam.Split(new[] { " + " }, StringSplitOptions.RemoveEmptyEntries))
            {
                string[] keyValue = part.Split('=');
                if (keyValue.Length == 2)
                {
                    paramDict[keyValue[0]] = HttpUtility.UrlDecode(keyValue[1]);
                }
            }

            if (paramDict.ContainsKey("job") && paramDict.ContainsKey("city"))
            {
                string newFriendlyTerm = $"{paramDict["job"].ToLower()}-in-{paramDict["city"].Replace(" ", "-").ToLower()}";
                var routeValues = new RouteValueDictionary { { "friendlySearchTerm", newFriendlyTerm } };
                string newFriendlyUrl = RouteTable.Routes.GetVirtualPath(null, "SearchFriendly", routeValues).VirtualPath;
                
                // 永久重定向，利于SEO
                Response.RedirectPermanent(newFriendlyUrl);
            }
        }
    }
}

关键说明 #

• 路由匹配顺序：自定义路由必须在EnableFriendlyUrls之前注册，否则FriendlyUrls的规则会先匹配，导致自定义路由失效
• 友好URL标准化：统一使用小写、连字符分隔，避免大小写混乱和URL不规范
• 旧URL重定向：添加永久重定向（301）可保留SEO权重，避免重复内容被搜索引擎惩罚

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