phpcms搜索功能失效？手把手排查修复步骤 附常见问题解决方案

很多用phpcms搭建的老站，运营好几年后经常突然出现搜索功能用不了的问题，要么点搜索没反应，要么搜任何内容都显示无结果，既影响用户找内容，还会拖慢搜索引擎收录节奏。本文整理了一线运维里最常见的失效原因，一步步带你排查，就算是新手也能照着操作解决问题。

先排查最容易解决的基础配置问题

大部分搜索失效都是小配置出问题，先从这几步查起，不用上来就动数据库改代码。

1、检查搜索模块是否正常启用

很多站长升级phpcms版本、清理后台功能的时候，很容易误关闭搜索模块。操作方法也很简单：登录网站后台，找到模块管理-已安装模块，看看“搜索”模块是否显示为启用状态，如果是未启用，点击启用就能解决问题。

2、检查缓存目录读写权限

phpcms的搜索结果会生成临时缓存，如果网站迁移后缓存目录权限不对，没办法读写缓存，搜索功能自然用不了。登录服务器找到网站根目录下的cache目录，把目录权限设置为755（可读写），设置完成后清空旧缓存再测试搜索即可。

数据库层面常见问题排查

如果基础配置没问题，那就要看看数据库是不是出问题了，很多新手在做phpcms搜索功能失效修复的时候，很容易漏掉这一步。

1、确认搜索相关数据表存在

很多站长迁移网站的时候，因为数据库文件太大，漏导了搜索相关的表，或者之前清理冗余数据误删了搜索表。登录数据库管理工具（比如phpMyAdmin），找到你的网站数据库，确认有没有v9_search、v9_search_keyword这两张核心表，如果不存在，可以从phpcms官方原版安装包导出对应表结构，导入到你的数据库即可。

2、修复损坏的搜索索引

如果网站内容量很大，搜索索引长期更新很容易出现索引损坏，这个时候只需要在数据库执行一条修复语句即可：

``` OPTIMIZE TABLE `v9_search`; ```

执行完成后清空网站缓存，再测试搜索功能基本就能恢复。

伪静态规则不匹配导致的搜索失效

很多站长把网站从Apache环境换到Nginx环境，或者改版修改了全站伪静态规则，很容易把搜索的路由规则写错，导致搜索打不开或者无结果。做phpcms搜索功能失效修复的时候，这类环境变更导致的问题占比能达到三成左右。

排查方法很简单：先临时关闭全站伪静态，直接访问你的域名/index.php?m=search，如果能正常打开搜索页，说明就是伪静态规则错了，替换成对应环境的正确规则即可。

Nginx环境常用搜索伪静态规则参考：

``` rewrite ^/(search.)$ /index.php?m=search&$1 last; ```

Apache环境规则参考：

``` RewriteRule ^(search.)$ index.php?m=search&$1 [L] ```

前端模板调用错误导致的显示失效

还有一种情况是后台搜索功能本身是正常的，但是你修改前端模板的时候误删或者改了搜索结果的调用代码，导致前端不显示结果，很多新手会误以为搜索功能失效了。这也是phpcms搜索功能失效修复过程中很容易被漏掉的细节。

你可以先还原默认的搜索模板测试，如果还原后能正常显示结果，说明就是你自定义模板的调用代码出了问题，对照默认模板检查搜索结果循环、参数调用部分的代码，修正错误即可。

现在很多老牌内容站还在跑phpcms，毕竟程序轻量稳定，就算官方好久不更新，遇到这类小问题也不用慌，大多都是环境迁移、权限变更这类操作遗留的小问题，顺着步骤一步步排查，十来分钟基本就能解决，没必要因为一个小功能就整站换程序折腾，反而容易影响网站本来的权重和收录。