配置.htaccess自定义404页面：RewriteRule与ErrorDocument兼容问题求助

现有配置的问题 #

1. 重复的<IfModule>块：无需拆分两个mod_rewrite模块检查，合并为一个即可，且RewriteEngine on只需声明一次。
2. 末尾斜杠规则的潜在问题：现有规则会对所有不含点且不以/结尾的URL加斜杠，但未排除真实存在的目录（Apache默认会为目录自动添加斜杠，可能导致重复跳转）。
3. ErrorDocument失效：所有不存在的文件/目录请求都被RewriteRule导向了index.php，Apache不会触发原生404，因此ErrorDocument配置无法生效。
4. HTTPS跳转的冗余：现有规则拆分了www移除和HTTPS强制跳转，可合并为一条规则提升效率。

优化后的.htaccess配置 #

<IfModule mod_rewrite.c>
    RewriteEngine On

    # 1. 移除www并强制HTTPS，一次完成跳转
    RewriteCond %{HTTP_HOST} ^www\.(.*)$ [NC,OR]
    RewriteCond %{HTTPS} !on
    RewriteRule ^(.*)$ https://%1/$1 [R=301,L]
    # 注：当HTTPS条件触发时，%1为空，Apache会自动使用当前非www的域名完成跳转

    # 2. 为非文件、非目录的URL添加末尾斜杠
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteCond %{REQUEST_URI} !(/$|\.)
    RewriteRule ^(.*)$ /$1/ [R=301,L]

    # 3. 将所有非真实文件/目录的请求导向index.php处理路由
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteRule ^ index.php [L]

    # 该配置仅对Apache原生触发的404生效（如访问不存在的静态文件）
    ErrorDocument 404 /errors/404.php
</IfModule>

自定义404页面的正确实现 #

由于所有路由请求都由index.php接管，404逻辑需在PHP中处理，具体步骤如下：

1. 优化index.php的路由匹配逻辑：

<?php
// 清理请求URI，去除末尾斜杠与查询参数
$url_requested = rtrim(parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH), '/');
// 空值默认设为首页路径
$actual_path = $url_requested ?: '/';

// 路由映射表，可按需扩展
$routes = [
    '/' => 'pages/home.php',
    '/about' => 'pages/about.php',
    // 更多路由规则...
];

// 匹配路由或触发404
if (isset($routes[$actual_path])) {
    include_once $routes[$actual_path];
} else {
    http_response_code(404);
    include_once 'errors/404.php';
    exit;
}
?>

2. 创建自定义404页面（例如errors/404.php）：

<?php
http_response_code(404);
?>
<!DOCTYPE html>
<html>
<head>
    <title>404 - 页面未找到</title>
</head>
<body>
    <h1>404 页面未找到</h1>
    <p>您访问的页面不存在，请检查URL是否正确。</p>
</body>
</html>

关键注意事项 #

• 跳转规则测试：测试阶段建议使用R=302临时跳转，确认配置无误后再改为R=301永久跳转，避免浏览器缓存错误规则。
• 静态文件404：访问不存在的静态文件（如/nonexist.jpg）时，Apache会直接触发ErrorDocument配置的404页面，无需PHP介入。
• 路由扩展性：使用数组存储路由映射比多段if-else更易维护，后续可扩展为正则匹配路由等更灵活的方案。

内容的提问来源于stack exchange，提问作者Rajesh Dai