海洋 CMS 模板支持自定义 404 页面吗

海洋 CMS（SeaCMS）支持自定义 404 页面，但它不是后台里一个"开关"式的功能，而是要靠两步配合完成：在模板目录里放一个 404 文件，再让 Web 服务器把 404 错误指向它。只做其中一步，通常看到的是服务器默认的错误页，而不是你自己设计的页面。

海洋 CMS 的 404 页面应该在哪里改？

结论：404 页面涉及两个位置——服务器配置（Nginx 或 Apache）和模板目录下的 404 文件，两者必须同时配置才生效。

服务器负责"什么时候触发 404"——也就是用户访问了一个数据库里不存在的视频、不存在的栏目、或者被删掉的链接时，由 Web 服务器抛出 404 状态。模板目录里的文件负责"404 时长什么样"——版式、导航、搜索框、推荐位都写在这个文件里。

很多人只在模板里放了一个 404.html 就不管了，结果访问不存在的地址时返回的还是服务器自带的英文错误页，原因就是服务器压根没被告知要去读那个文件。

自定义 404 页面的具体步骤是什么？

结论：按"建文件 → 配服务器 → 验状态码"三步走，10 分钟内能完成。

第一步，准备 404 文件。 在你的模板目录下（海洋 CMS 的模板统一放在 template/ 下的模板名文件夹里），新建 404.php 或 404.html。如果程序包根目录里已经带了 404.php，直接改它更稳妥，避免路径冲突。页面里建议放：站点名、一句"页面不存在或已下架"的说明、全站搜索框、返回首页按钮、以及几个热门栏目链接。

第二步，配置 Web 服务器。

Nginx 站点配置里加：

error_page 404 /404.php;
location = /404.php {
    internal;
}

Apache 则在站点根目录的 .htaccess 里加一行：

ErrorDocument 404 /404.php

第三步，验证。 改完配置后重载服务（nginx -s reload 或重启 Apache），然后随便访问一个不存在的地址，比如 你的域名/this-page-not-exist.html。

为什么我的 404 页面返回的是 200 状态码？

结论：这是典型的"软 404"，SEO 上等同于告诉搜索引擎这个页面是正常存在的，必须修掉。

判断方法很简单：打开浏览器开发者工具（F12）的 Network 面板，或者用 curl -I 你的域名/不存在的地址 看返回头。如果 HTTP/1.1 后面跟的是 200，说明你的 404 文件被当成了普通页面输出。

修正办法：在 404.php 的最顶部、任何 HTML 输出之前，加上状态码声明：

<?php
http_response_code(404);
?>

注意这行必须放在文件第一行，前面不能有空格、BOM 头或任何输出，否则会报 "headers already sent"。如果你用的是纯 404.html，Nginx 的 error_page 404 /404.html; 会自动带上 404 状态，不用额外处理。

开启静态化生成 HTML 后，404 还有效吗？

结论：有效，但需要服务器级别的兜底规则，因为静态化后页面是纯 HTML 文件，不再经过 PHP 路由。

海洋 CMS 支持把列表页、内容页生成为静态 HTML。这种情况下，判断"页面是否存在"的工作从 PHP 转移到了 Web 服务器。在 Nginx 里配好 error_page 404 依然有效，但要确保伪静态规则里有 try_files 兜底，例如：

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

同时，每次删除了视频或栏目后，记得清理对应的静态文件和缓存，否则用户访问旧链接时文件还在，会返回 200 而不是 404。

几个容易踩的坑

• 模板缓存没清：改完 404 文件后如果后台开了模板缓存，需要清一次缓存才能看到新版式。
• 路径写错：error_page 后面的路径是相对于站点根目录的，如果你的程序装在子目录（如 /cms/），要写成 /cms/404.php。
• 别用 302 跳转到首页：有些站长图省事，把 404 直接 302 跳到首页。这会让搜索引擎认为所有无效链接都是首页的重复内容，长期看对收录不利。想要更好的体验，用 404 页面加站内搜索引导比跳转更合适。

总结一下：海洋 CMS 自定义 404 的关键是"模板文件 + 服务器 error_page"双配置，做完后用 curl -I 确认返回码确实是 404 而不是 200，静态化站点额外加 try_files 兜底并注意清理旧静态文件。这三步做到了，404 页面就能既好看又不伤 SEO。