本文详解如何通过 .htaccess 配置自定义 404 页面，并在 PHP 脚本中安全、准确地获取用户访问的原始 URL 路径（如 /example），适用于 SEO 友好跳转、动态错误处理或路由兜底等场景。
本文详解如何通过 `.htaccess` 配置自定义 404 页面，并在 php 脚本中安全、准确地获取用户访问的原始 url 路径（如 `/example`），适用于 seo 友好跳转、动态错误处理或路由兜底等场景。
当用户访问一个不存在的路径（例如 https://test.de/example），Apache 默认返回标准 404 响应。若希望将其优雅降级至自定义 PHP 页面（如 404.php），并保留原始请求路径用于后续逻辑处理（如日志记录、智能重定向或前端渲染），需正确配置服务器与脚本协同机制。
✅ 正确配置 .htaccess
在网站根目录下创建或编辑 .htaccess 文件，添加以下指令：
ErrorDocument 404 /404.php
⚠️ 注意：路径 /404.php 必须以斜杠开头，表示相对于站点根目录（DocumentRoot）；不能写成 ./404.php 或 404.php，否则 Apache 将无法正确定位。
✅ 在 404.php 中获取原始请求路径
Apache 在触发 ErrorDocument 时，会保留原始请求的环境变量。此时，$_SERVER['REQUEST_URI'] 的值即为用户最初输入的完整路径（含查询参数），例如：
- 用户访问 https://test.de/example?ref=home → $_SERVER['REQUEST_URI'] 返回 /example?ref=home
- 用户访问 https://test.de/abc/def/ → 返回 /abc/def/
因此，在 404.php 中可直接使用：
<?php
$originalPath = $_SERVER['REQUEST_URI'] ?? '/';
// 安全截取路径部分（不含查询参数）
$pathOnly = parse_url($originalPath, PHP_URL_PATH);
echo "<h2>未找到页面：</h2>";
echo "<p>您尝试访问：<code>" . htmlspecialchars($pathOnly) . "</code></p>";
// 示例：根据路径前缀做智能跳转
if (str_starts_with($pathOnly, '/api/')) {
http_response_code(404);
echo "<p>API 接口不存在，请检查文档。</p>";
} elseif ($pathOnly === '/admin') {
header('Location: /login?redirect=' . urlencode($pathOnly));
exit;
}
?>⚠️ 关键注意事项
- 不要依赖 $_SERVER['REDIRECT_URL'] 或 $_SERVER['REDIRECT_QUERY_STRING']：这些变量在 ErrorDocument 场景下行为不稳定，尤其在多层重写或 FastCGI 环境中可能为空或被覆盖。
- 始终对输出内容进行 HTML 转义：$_SERVER['REQUEST_URI'] 可被恶意构造（如含 XSS 载荷），直接输出存在安全风险，务必使用 htmlspecialchars() 处理。
-
确保响应状态码为 404：虽然 Apache 已发送 404 状态，但若 404.php 内部执行了 header('Location: ...') 或 http_response_code(200)，将覆盖原始状态码，影响搜索引擎和爬虫判断。如需重定向，请显式设置：
http_response_code(302); // 或 301 header('Location: /fallback'); exit; - 避免循环重定向：确保 404.php 自身路径不会触发新的 404（例如文件权限错误、路径拼写错误），建议部署前用 curl -I https://test.de/404.php 验证其可访问性。
✅ 总结
通过 ErrorDocument 404 /404.php 配置 + $_SERVER['REQUEST_URI'] 读取，即可轻量、可靠地捕获原始请求路径。该方案兼容所有标准 Apache 部署（包括共享主机），无需启用 mod_rewrite 或复杂规则，是构建健壮前端路由或错误处理系统的基石实践。
