本文详解如何通过 .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'] 的值即为用户最初输入的完整路径（含查询参数），例如：
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
- 用户访问 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 或复杂规则，是构建健壮前端路由或错误处理系统的基石实践。
