ASP.NET Core MVC 如何实现布局页内的全局搜索功能

核心逻辑的正确归属位置 #

针对你提出的“搜索逻辑应该放在哪”的问题，直接给出结论：搜索逻辑必须封装在独立的Search控制器中，不要散落在其他业务控制器、布局页代码块中。
原因：布局页是全站所有页面复用的公共组件，不绑定某一个具体业务模块；全局搜索本身是跨业务实体的通用功能（比如同时检索文章、商品、用户信息），如果把搜索逻辑塞到Home、Product这类业务控制器中，会造成模块强耦合，后续调整搜索规则、加权限校验、对接第三方搜索服务时，会牵一发动全身。

分步实现流程 #

1. 在布局页定义全局搜索表单 #

打开Views/Shared/_Layout.cshtml，在导航栏的公共位置插入搜索表单，利用ASP.NET Core的Tag Helper直接指定提交的目标地址：

<!-- 布局页导航栏区域的搜索框 -->
<form class="form-inline" asp-controller="Search" asp-action="Index" method="get">
    <input 
        class="form-control mr-sm-2" 
        type="search" 
        placeholder="输入关键词搜索" 
        name="query">
</form>

关键设计说明：

• 用method="get"而不是post：搜索是幂等操作，生成的URL可以直接收藏、分享，用户刷新搜索结果页不会触发重复提交的提示
• 不需要写额外的JS监听回车事件：只要input在form内部，用户按下回车键会原生触发表单提交，这是浏览器的默认行为，自己写keydown拦截反而容易出现重复触发、事件不生效的bug
• input的name属性必须和后续控制器的接收参数名完全一致，否则会出现参数传递丢失的问题

2. 搭建独立的Search控制器承载搜索逻辑 #

在项目的Controllers文件夹下新建SearchController.cs，把所有和搜索相关的逻辑全部封装在这里：

using Microsoft.AspNetCore.Mvc;
using Microsoft.EntityFrameworkCore;

public class SearchController : Controller
{
    private readonly AppDbContext _dbContext;
    // 按需注入你用到的数据库上下文、业务服务
    public SearchController(AppDbContext dbContext)
    {
        _dbContext = dbContext;
    }

    // 接收布局页传过来的搜索关键词
    public async Task<IActionResult> Index(string query)
    {
        // 空关键词兜底：直接重定向回首页
        if (string.IsNullOrWhiteSpace(query))
        {
            return RedirectToAction("Index", "Home");
        }

        // 在这里写具体的跨模块搜索逻辑
        // 例：匹配文章标题、内容中包含关键词的记录
        var matchedArticles = await _dbContext.Articles
            .Where(a => a.Title.Contains(query) || a.Content.Contains(query))
            .ToListAsync();
        // 例：匹配商品名称、描述中包含关键词的记录
        var matchedProducts = await _dbContext.Products
            .Where(p => p.Name.Contains(query) || p.Description.Contains(query))
            .ToListAsync();

        // 把结果组装成视图模型传给搜索结果页
        var resultModel = new SearchResultViewModel
        {
            SearchKey = query,
            ArticleResults = matchedArticles,
            ProductResults = matchedProducts
        };
        return View(resultModel);
    }
}

适配提示：如果你的搜索需要登录权限，直接在这个控制器上加[Authorize]特性即可，全局生效，不需要在每个业务控制器里重复配置。

3. 配套搜索结果视图 #

在Views/Search/文件夹下新建Index.cshtml作为搜索结果页，正常引入布局页即可——因为路由跳转到/Search?query=xxx的时候，会自动加载公共的_Layout文件，导航栏、搜索框这些公共组件不会丢失，不需要重复写公共代码。

常见踩坑规避 #

• 不要把搜索逻辑写在布局页的Razor代码块里：布局页的代码是所有页面加载时都会执行的，把搜索逻辑塞进去会造成不必要的性能消耗，且无法通过路由、权限规则管控
• 不要用硬编码的路由写表单提交地址：比如直接写action="/Search/Index"，当项目部署在子目录的时候会出现路由404的问题，用Tag Helper生成的地址会自动适配项目的路由配置
• 如果想要实现无刷新的弹层搜索效果，不需要改动后端逻辑：只需要在前端拦截form的默认提交行为，用Ajax请求/Search/Index?query=关键词拿到结果，渲染到弹层组件里即可，后端的搜索逻辑完全可以复用。

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