在 apache 中通过 url 重写实现自定义 404 页面重定向，核心方法是使用 rewriterule 配合 r=404 标志。具体做法是开启 mod_rewrite，定义一个规则匹配所有请求，并指定返回的自定义 html 文件路径。这样做会强制服务器向客户端发送状态码 404，同时展示你指定的内容，而不是默认的 apache 错误页。
如何配置 RewriteEngine 和基础规则
要实现这一功能，必须在 .htaccess 文件或虚拟主机配置中启用 RewriteEngine On。接着，编写一条规则来捕获所有未匹配到实际文件的请求。通常我们会先检查文件是否存在，如果不存在，则触发重写逻辑。这一步确保了只有真正的 404 情况才会被处理，避免干扰正常资源加载。
<ifmodule mod_rewrite.c>
RewriteEngine On
# 如果请求的文件或目录存在，则不重写
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
# 将所有非文件/非目录请求重定向到自定义 404 页面
# R=404 确保发送正确的 HTTP 状态码
RewriteRule ^(.*)$ /custom-404.html [R=404,L]</ifmodule>
上述代码首先通过 RewriteCond 排除存在的文件和目录。然后 RewriteRule 将剩余的所有请求（^.*$）指向 /custom-404.html。R=404 是关键参数，它告诉 Apache 这是一个 404 错误，而不仅仅是内部跳转。L 表示这是最后一条规则，停止后续处理。预期结果是：访问一个不存在的 URL（如 /nonexistent），浏览器地址栏显示该 URL，但内容来自 /custom-404.html，且网络面板中状态码为 404。
如何处理带查询字符串的重写
当 URL 包含查询字符串时，默认情况下 RewriteRule 不会自动附加这些参数到目标 URL。如果需要保留原始查询字符串以便在自定义页面中显示“未找到”的具体路径，可以使用 QSA（Query String Append）标志。此外，有时我们希望即使有查询字符串也统一跳转到静态 404 页面，这时需要明确控制行为。
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
<ifmodule mod_rewrite.c>
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
# 添加 QSA 以保留查询字符串
RewriteRule ^(.*)$ /custom-404.html?original=%{REQUEST_URI}%{QUERY_STRING} [R=404,L,QSA]
</ifmodule>
在这个变体中，QSA 标志确保原始查询字符串被追加到重写目标的末尾。我们还将原始 URI 作为参数传递给 custom-404.html，这样 PHP 或 JS 可以读取 ?original=... 来动态显示错误信息。例如，访问 /missing-page?id=123 会重定向到 /custom-404.html?original=/missing-page&id=123。注意，R=404 依然保持状态码正确。如果不需要保留任何信息，只需移除 QSA 和目标后的参数部分即可。这种配置适用于需要调试或记录用户尝试访问的不存在路径的场景。
基于程序中某个输入、条件或结果的具体问题
在实际应用中，一个常见的问题是：如果自定义 404 页面本身也是一个动态脚本（如 /error/404.php），并且该脚本内部又触发了新的重写规则，会导致循环重定向或无限循环。这是因为 RewriteRule 会再次匹配 /error/404.php，如果它不存在于磁盘上，就会再次触发规则。
<ifmodule mod_rewrite.c>
RewriteEngine On
# 排除自定义错误页面本身，防止循环
RewriteCond %{REQUEST_URI} !^/custom-404\.html$
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ /custom-404.html [R=404,L]
</ifmodule>
解决这个问题的关键是在规则前增加一个 RewriteCond，显式排除自定义 404 页面的路径。如上所示，%{REQUEST_URI} !^/custom-404\.html$ 确保当请求直接指向 /custom-404.html 时，重写规则不会生效。这样，Apache 会直接提供该文件（如果存在）或交由其他处理器（如 PHP）处理，而不会进入重写循环。验证方法是：访问一个不存在的 URL，确认页面正常加载且无重定向循环报错。此方法确保了系统的稳定性，避免了因配置不当导致的服务器性能下降或客户端错误。
