海洋 CMS 站内搜索功能失效怎么修复

海洋CMS站内搜索失效，问题基本落在四处：伪静态规则丢失、中文关键词未做 URL 编码、缓存或目录权限没刷新、后台搜索开关被关掉。按下面四步顺序排查，能直接定位到是哪一处，不用逐个文件翻代码。

怎么判断是伪静态问题还是程序问题

结论：先用「直连参数」的方式访问一次，一次就能把故障范围砍一半。

打开浏览器访问 https://你的域名/search.php?wd=测试（把 wd 换成你模板里实际接收的变量名，常见是 wd、searchword、keyword，以站点根目录 search.php 开头几行的 $_GET 取值为准）。

• 能正常出结果：说明 PHP 和数据库都正常，故障 100% 在伪静态规则。
• 返回 404：search.php 文件被误删或服务器没放行该文件。
• 返回 500 或白屏：PHP 报错了，去 error_log 或后台日志看最后一条错误。
• 页面能开但永远显示「没有找到相关内容」：问题在数据库查询或关键词编码。

伪静态规则怎么写才生效

结论：伪静态失效是搜索打不开的第一大原因，改完必须重启或重载 Web 服务。

Apache 环境检查两点：根目录 .htaccess 是否存在；虚拟主机配置里 AllowOverride All 是否打开（写成 None 时 .htaccess 直接不生效）。用 apache2ctl -M | grep rewrite 或 httpd -M | grep rewrite 确认 rewrite_module 已加载。

Nginx 环境用 nginx -V 2>&1 | grep -o with-http_rewrite_module 确认模块编译进去了，然后在站点配置里加搜索转发规则，写法形如：

rewrite ^/search/(.*)$ /search.php?wd=$1 last;

改完执行 nginx -s reload 或 systemctl reload httpd，再访问一次搜索页。

中文关键词搜不到结果怎么办

结论：中文搜索失败的根源是编码不一致，关键词必须以 URL 编码形式传给服务器。

浏览器直接粘贴中文关键词，部分服务器会按 GBK 解析，而数据库存的是 UTF-8，查出来自然是空。验证命令：

curl -I "https://你的域名/search.php?wd=%E6%B5%8B%E8%AF%95"

%E6%B5%8B%E8%AF%95 就是「测试」的 UTF-8 编码。这条能出结果而直接输中文不行，就是编码问题。

再确认数据库编码：登录 MySQL 执行 SHOW VARIABLES LIKE 'character_set_database';，正常值应为 utf8mb4 或 utf8。同时检查 search.php 里连接数据库后有没有执行 SET NAMES utf8，缺这一句会导致中文查询条件被截断。

缓存和权限导致的「假失效」怎么处理

结论：清缓存、改权限这两步能解决搜索页突然报错或时好时坏的情况。

清缓存：删除根目录 data/cache/ 下的全部缓存文件，再进后台点「清除缓存」。搜索模块的模板编译文件一般也在 data/ 或 templates/ 的缓存目录中，模板改过之后不清缓存，前台还是旧页面。

改权限：Linux 环境下目录设 755、文件设 644，属主为 Web 运行用户：

chown -R www:www data
chmod -R 755 data
find data -type f -exec chmod 644 {} \;

搜索词会写入搜索日志表，如果 data/ 目录不可写，写入失败会直接中断搜索流程，前台表现就是「搜什么都报错」。

最后别忽略后台开关：进后台「系统设置」里的搜索相关项，确认「开启站内搜索」是打开的，并且「搜索间隔时间」没有设成过大值——设成 10 秒以上时，连续搜索会被拦住，看起来就像功能坏了。

修复后怎么验证

结论：三个动作全部通过，才算真正修好。

1. 直连测试 search.php?wd=%E6%B5%8B%E8%AF%95 能出结果；
2. 访问伪静态地址（形如 /search/测试.html）能出结果；
3. 手机端和 PC 端各搜一次中文词、一次英文词，结果条数与后台影片库数量对得上。

三项都通过后，再把 data/cache/ 权限和伪静态配置记录到自己的运维笔记里，下次换服务器直接照抄。

总结一下：搜索失效先直连 search.php?wd= 定位范围，伪静态问题查 .htaccess/Nginx 规则和 rewrite 模块，中文搜不到查 URL 编码与 SET NAMES utf8，最后清缓存、给 data/ 目录 755 权限、确认后台搜索开关与间隔设置。