本文详解如何通过 .htaccess 配置自定义 404 页面，并在 PHP 脚本中准确捕获用户访问的原始 URL 路径（如 /example），避免重定向丢失上下文，适用于前端路由、单页应用或动态内容托管场景。
本文详解如何通过 `.htaccess` 配置自定义 404 页面，并在 php 脚本中准确捕获用户访问的原始 url 路径（如 `/example`），避免重定向丢失上下文，适用于前端路由、单页应用或动态内容托管场景。
在基于 Apache 的 Web 服务中，当用户访问一个不存在的路径（例如 https://test.de/example）时，服务器默认返回标准 404 响应。若需将此类请求统一交由 PHP 动态处理（如实现前端路由 fallback、个性化错误页或路径代理），必须正确配置错误文档并确保原始请求信息不丢失。
✅ 正确配置 .htaccess
在网站根目录下创建或编辑 .htaccess 文件，添加以下指令：
ErrorDocument 404 /404.php
⚠️ 注意：路径 /404.php 必须以斜杠开头，表示相对于站点根目录的绝对路径；不能写成 ./404.php 或 404.php，否则 Apache 可能无法定位文件，导致配置失效或循环重定向。
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
✅ 在 PHP 中获取原始请求路径
Apache 在触发 ErrorDocument 时，会保留原始请求的环境变量。你可在 404.php 中直接使用：
<?php // 获取用户最初请求的完整 URI（含查询参数） $originalPath = $_SERVER['REQUEST_URI'] ?? '/'; // 示例输出：/example echo "您访问的路径是：". htmlspecialchars($originalPath); // 进阶用法：解析路径段、匹配路由、记录日志等 $pathInfo = parse_url($originalPath, PHP_URL_PATH); // $pathInfo 将返回 '/example'（不含 query string） ?>
✅ $_SERVER['REQUEST_URI'] 是最可靠的方式——它原样保留了用户浏览器发起的请求路径（如 /example?ref=home），包括路径和查询字符串，且不受重定向影响。
⚠️ 常见误区与注意事项
- ❌ 不要使用 $_SERVER['REDIRECT_URL'] 或 $_SERVER['PHP_SELF']：前者在某些 Apache 版本中不可靠，后者仅返回当前脚本路径（即 /404.php），无法反映原始请求。
- ❌ 避免在 .htaccess 中使用 RewriteRule 模拟 404（如 RewriteRule ^(.*)$ /404.php [L]）：这会覆盖真实 404 状态码为 200，不利于 SEO 和调试；而 ErrorDocument 保持 HTTP 状态码为 404 Not Found，语义正确。
- ✅ 推荐在 404.php 开头显式设置状态码（尽管 Apache 已设置，但增强兼容性）：
http_response_code(404); header('Content-Type: text/html; charset=utf-8');
? 总结
通过 ErrorDocument 404 /404.php 配置 + $_SERVER['REQUEST_URI'] 读取，即可轻量、可靠地实现“404 路由接管”。该方案无需额外模块、兼容主流 Apache 版本（2.2+），是构建 SPA（如 Vue/React History 模式）、静态站点动态路由或智能错误处理的基础实践。务必确保 PHP 文件存在、权限可读，且 .htaccess 启用（AllowOverride All）。
