本文详解如何通过 .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 可能无法定位文件，导致配置失效或循环重定向。
✅ 在 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）。
