WordPress搜索功能故障别慌！过来人整理的实用排障攻略

先唠唠我碰到的WordPress搜索功能故障，像不像你家点菜柜卡壳？

我一直把自己的WordPress站点比作开在互联网巷口的个人小吃店，网站内容就是我卖的各种小吃，访客进来想吃啥全靠搜索找，搜索功能就是店里的智能找菜柜——结果哪想到，开张没俩月我就碰到了WordPress搜索功能故障！不对，就是碰到了WordPress搜索功能故障！

什么症状呢？你说你搜个「副业赚钱」，明明我写过三篇相关干货，它直接给你弹个「没找到相关内容」，就像你要吃酸辣粉，找菜柜直接说我家没这货；要么就是搜出来一堆八竿子打不着的内容，你要藤椒鱼它给你蹦出来三碗白米饭，给你整得一脸懵；最过分的是直接出404，点完搜索直接给你把门焊死，这不就是妥妥的WordPress搜索功能故障嘛！

当时我刚碰这个事儿，慌得一批，以为我站点被黑了、数据丢了，翻了后台一看文章都好好的，就搜索坏了，为了修这个WordPress搜索功能故障，我熬了两个大夜，踩了七八个坑，现在总算是稳了，今天就把我这个过来人踩过的坑、试过的好使法子全给你唠明白。

先排雷：这些坑最容易导致WordPress搜索功能故障

坑1：默认搜索自带先天缺陷，本来就容易出故障

很多新手不知道，WordPress自带的默认搜索，就是厂家送你的免费找菜柜，本来就是凑合用的，质量真不咋地。专业点说，默认搜索只检索文章的标题和正文片段，你要是用了自定义文章类型、自定义字段（比如做产品站、资源站的时候加的分类参数），它根本就不会去索引这些内容，你内容早就发上去了，搜索根本没把它记在小本本上，你搜可不就是搜不到，这不就成了WordPress搜索功能故障了？我一开始做资源站，加了「工具标签」这个自定义字段，结果半年了搜标签都搜不到，我还以为出啥天大的问题，原来就是默认搜索天生懒，不想干活。

坑2：插件主题抢道，把搜索路给堵死了

这个是最常见的导致WordPress搜索功能故障的原因！真的，我这次出问题就是这个锅。就像你给找菜柜装了个好看的网红柜门，又加了俩挂零食的挂篮，结果装好发现柜门拉不开了——这些额外装的东西挡着轨道了。

放到技术上说就是，很多美化主题、缓存插件、安全插件，都会用钩子改WordPress的搜索查询请求，要么就是把搜索页面给缓存了，你每次搜出来都是半年前的旧内容；要么就是安全插件觉得搜索请求是恶意访问，直接给拦截了，这不就出了WordPress搜索功能故障嘛！我上次就是装了个热门的缓存插件，忘了把搜索结果页排除缓存，结果半个月后有人给我留言说搜啥都不对，我才发现这个问题，真的坑死人。

坑3：固定链接配置错了，搜索直接找不到家门

这个坑虽然偏，但碰到了就是百分百WordPress搜索功能故障。你改了站点的固定链接结构，或者换了域名之后没更新配置，搜索的路由地址错了，用户点搜索之后请求发不到地方，直接就跳404，就像你找菜柜插错了插座，根本不通电，你说它能干活吗？

亲测有效的排障步骤，跟着走十分钟搞定

第一步：先排查插件主题冲突，最快定位问题

首先你按照我说的来，先把所有插件全停用，然后换成WordPress默认的Twenty Twenty系列主题，然后去前台搜一下试试。如果这时候搜索好了，那肯定就是插件或者主题的问题，就是我们刚才说的挡道了，接下来你再一个一个启用插件，开一个搜一次，哪个开了之后又出现WordPress搜索功能故障，哪个就是凶手，直接换掉或者调整设置就好了。

要是你用缓存插件，记得一定要把搜索结果页排除缓存，这个设置一般都在缓存插件的高级设置里，花三十秒改一下，就能避免大半WordPress搜索功能故障，真的，这个我亲测，改完之后好多了。

第二步：修复默认搜索的索引缺陷，不想换插件就改几行代码

要是排查完冲突还是出WordPress搜索功能故障，那大概率就是默认搜索的先天缺陷，不想换插件的话，加几行代码就能让默认搜索索引自定义字段，我把我用过的代码放这，直接粘到你主题的functions.php文件最后就好了：

``` // 让WordPress搜索支持索引自定义字段 function add_custom_fields_to_wp_search($search_sql, $wp_query) { global $wpdb; $search_term = $wp_query->get('s'); if (!empty($search_term) && $wp_query->is_search()) { $search_sql .= " OR {$wpdb->postmeta}.meta_value LIKE '%{$search_term}%' "; } return $search_sql; } add_filter('posts_search', 'add_custom_fields_to_wp_search', 10, 2); ```

这个代码我用了快两年了，没出过问题，加完之后默认搜索就能搜到自定义字段里的内容了，大部分因为索引不全导致的WordPress搜索功能故障直接就好，是不是很简单？

第三步：嫌麻烦直接换搜索工具，一了百了

要是你不想改代码，也不想天天提心吊胆怕再出WordPress搜索功能故障，那直接换个第三方搜索插件就好了，我试过好几个，给你说两个靠谱的，都是我踩过坑留下来的：

• 新手做个人站、博客，直接用SearchWP，这个插件真的香，一键就能索引所有内容，包括自定义文章类型、自定义字段、甚至附件内容都能搜，设置简单，点几下就好了，我现在用的就是这个，大半年没出过WordPress搜索功能故障，稳得一批。
• 要是你是流量比较大的站点，不想占服务器资源，直接用百度站内搜索或者Algolia，把搜索放到第三方服务器，根本不会拖累你站点速度，也不会出WordPress搜索功能故障，就是需要简单配置下，稍微花点时间，也不难。

最后给刚玩WordPress的新手唠两句掏心窝子的

其实我原来一碰到WordPress搜索功能故障就慌，总觉得是我哪里搞错了，要把站点推倒重来，后来踩过坑才知道，百分之九十的WordPress搜索功能故障都是小问题，就是你没找对问题出在哪，按照我给你说的步骤，一步一步排查，十分钟基本就能搞定，实在搞不定换个搜索工具就好了，多大点事儿。

咱玩WordPress做站点，不就像开个小杂货店，哪能没个零件坏、抽屉卡的时候，修一修、换一换就好了，办法总比困难多，把小问题解决了，访客才能顺顺当当找到你内容，你的站点才能慢慢做起来对吧？我作为踩过所有坑的过来人，说句实在话，碰到WordPress搜索功能故障别慌，按我说的来，保准你能搞定！