海洋 CMS 伪静态设置完成页面打不开怎么办

海洋CMS 伪静态设置完打不开页面，99% 不是 CMS 坏了，而是「重写规则没真正生效」——要么服务器没加载重写模块，要么规则文件写错/没放对目录，要么规则路径和你实际的栏目结构对不上。按下面三步排查，通常 10 分钟内能定位。

为什么后台点了伪静态，前台反而全站打不开？

结论：伪静态开关只是告诉 CMS「生成什么形状的链接」，真正把链接翻译回 PHP 查询的是 Web 服务器（Nginx/Apache/IIS）的重写模块，两者任意一边没配对上，就是 404 或 500。

海洋CMS 后台的伪静态选项负责输出形如 /xxx/1.html 这样的地址，服务器则负责把这个地址改写成 index.php?参数=1 交给 PHP 执行。开关开了、规则没配，用户访问的是一个服务器上根本不存在的静态文件，返回 404 是必然结果。所以先分清症状：全站都打不开说明是服务器配置层面；只有内页打不开、首页正常说明规则只匹配了一部分路径。

第一步：确认服务器真的加载了重写模块

结论：Apache 环境下 mod_rewrite 没开、或站点目录的 AllowOverride 是 None，伪静态 100% 失效，且不会有任何提示。

Apache 用这条命令确认模块：

apachectl -M | grep rewrite

输出里必须出现 rewrite_module (shared)。没有就用 a2enmod rewrite（Debian/Ubuntu）或在 httpd.conf 里去掉 LoadModule rewrite_module 前面的注释。然后确认站点配置里目录段允许读取 .htaccess：

<Directory /www/wwwroot/你的站点>
    AllowOverride All
    Require all granted
</Directory>

Nginx 本身不需要模块，它的重写能力内置，但改完规则必须重载：

nginx -t && systemctl reload nginx

nginx -t 报 unknown directive 说明规则粘贴位置不对——rewrite、location 必须写在 server {} 块里，不能写到 http {} 外层。

第二步：核对规则文件，位置和写法都不能错

结论：规则文件的位置比内容更容易错——Apache 的 .htaccess 必须放在网站根目录（与 index.php 同级），Nginx 的规则必须写进对应站点的 server 块。

判断方法很直接：在网站根目录建一个 test.html，浏览器能访问到，就说明根目录判断对了。常见的三类错误：

1. 复制了别的 CMS 的规则。不同 CMS 的参数名和路径前缀不同，用 Discuz 或 WordPress 的规则套海洋CMS，结果就是重写后 PHP 收不到参数，页面空白或 404。
2. 规则里的目录名和你实际目录不一致。比如规则写的是 /vod/，实际站点部署在子目录 /cms/ 下，就必须整体加前缀，或者把站点改成根目录部署。
3. RewriteBase 缺失或写错。Apache 在子目录部署时，RewriteBase /cms/ 这一行不能少，少了就会出现「首页正常、内页跳回首页」的典型症状。

改完记得重启/重载服务，Nginx 用 reload，Apache 用 systemctl restart httpd。

第三步：清缓存并做回退测试

结论：先用「关掉伪静态」做对照实验，能立刻区分是规则问题还是 CMS 本身问题。

具体做法：后台关掉伪静态，访问原动态地址（如 index.php?id=1）。如果动态地址也打不开，问题在 PHP 或数据库，与伪静态无关；如果动态正常、伪静态异常，就把焦点放回规则。同时清掉三处缓存：CMS 后台的缓存、浏览器强刷（Ctrl+F5）、以及 CDN 或宝塔/面板层的缓存——有些面板会把 404 响应缓存住，让你误以为改了没用。

常见报错分别对应什么问题？

• 404 Not Found：规则未生效或路径不匹配，优先查第一步和第二步。
• 500 Internal Server Error：.htaccess 语法错误，或规则导致了无限循环，删掉规则文件即可恢复。
• 重定向次数过多：规则里对 .html 又重写了一次，或者 HTTP 跳 HTTPS 的规则和伪静态规则互相触发。
• 打开是空白页/首页：重写成功但参数没传对，属于规则内容不匹配，换用海洋CMS 后台自带的那份规则。

排查顺序固定为：模块 → 规则文件位置 → 规则内容 → 缓存。四步走完仍不通，把规则文件临时改名回退，先让站点恢复正常访问，再逐条添加规则定位问题行。伪静态不是必须项，稳定运行永远优先于 URL 好看。