Apache2.htaccess重写失败解决方法

本文深入剖析了 Apache2 中使用 .htaccess 实现嵌套 URL（如 `/en/about`）重写至 `index.php?url=...` 时频繁触发 404 的核心症结——并非简单启用 mod_rewrite 即可解决，而是源于虚拟主机 DocumentRoot 与 .htaccess 实际路径不一致、重写规则引发自循环、以及无差别拦截静态资源等隐蔽配置缺陷；文章不仅精准定位问题根源，更提供经过生产验证的健壮解决方案：通过 `RewriteBase` 对齐路径、用 `^index\.php$ - [L]` 阻断入口文件重入、结合 `!-f` 和 `!-d` 条件智能放行真实资源，确保路由重写既安全可靠又不影响 CSS/JS/图片等静态文件加载，助你彻底告别单页应用部署中的“神秘 404”。

本文详解 Apache2 下嵌套 URL（如 /en/about）重写到 index.php?url=... 时 404 的根本原因，涵盖配置路径不一致、重写规则自循环、静态资源误拦截等关键问题，并提供安全、健壮的 .htaccess 配置方案。

本文详解 Apache2 下嵌套 URL（如 `/en/about`）重写到 `index.php?url=...` 时 404 的根本原因，涵盖配置路径不一致、重写规则自循环、静态资源误拦截等关键问题，并提供安全、健壮的 `.htaccess` 配置方案。

在基于 PHP 的单入口应用中，常需将任意嵌套路径（如 /en/about、/zh/contact/us）统一交由 index.php 处理，通过 $_GET['url'] 解析路由。但实践中频繁出现 404 错误——表面看 .htaccess 已启用、mod_rewrite 已加载，问题实则隐藏于配置一致性与重写逻辑严谨性之中。

? 根本问题定位

首先，您当前的 Apache 虚拟主机配置存在路径不匹配：

<Directory /var/www/html/domain>   # ← .htaccess 生效目录在此
DocumentRoot /var/www/domain/      # ← 实际文档根目录却在此

若 .htaccess 文件实际位于 /var/www/domain/.htaccess，而 指向 /var/www/html/domain，则该文件根本不会被 Apache 加载，所有重写规则失效。请确保二者路径严格一致：

# ✅ 正确示例（假设项目在 /var/www/domain）
<Directory /var/www/domain>
    Options -Indexes +FollowSymLinks -MultiViews
    AllowOverride All
    Require all granted
</Directory>
DocumentRoot /var/www/domain

其次，原始重写规则存在逻辑缺陷：

RewriteRule .* index.php?url=$0 [QSA,L]

该规则会无差别重写所有请求，包括对 index.php 自身的访问，导致二次重写：
→ 请求 /en/about → 重写为 index.php?url=en/about
→ 但 index.php 再次被匹配 → 重写为 index.php?url=index.php&url=en/about
虽 PHP 仍可读取 $_GET['url'] 的最后一个值（因 QSA 合并参数），但 $_SERVER['QUERY_STRING'] 已污染，且存在潜在循环风险。

更严重的是，该规则还会重写 style.css、logo.png 等静态资源，导致样式丢失或脚本加载失败。

✅ 推荐的健壮 .htaccess 配置

以下配置已通过生产环境验证，兼顾安全性、可维护性与兼容性：

# 启用重写引擎并设置基础路径（需与 DocumentRoot 匹配）
RewriteEngine On
RewriteBase /

# 1. 直接放行对 index.php 的请求（避免自循环）
RewriteRule ^index\.php$ - [L]

# 2. 仅当请求路径不对应真实文件时，才重写到入口文件
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php?url=$1 [QSA,L]

关键说明：

• ^index\.php$ - [L]：精确匹配 index.php 并立即终止（[L]），杜绝重入；
• !-f 和 !-d：双重条件确保仅重写非文件、非目录的请求（如 /en/about），而 /css/app.css 或 /images/icon.svg 将直接由 Apache 原样响应；
• ^(.*)$ 替代 .*：更清晰地捕获整个路径，$1 引用更语义化；
• QSA（Query String Append）：保留原始查询参数（如 /en/about?id=123 → url=en/about&id=123）。

⚠️ 注意事项与调试建议

• 启用 Apache 日志辅助诊断：
  在虚拟主机配置中添加：

  LogLevel alert rewrite:trace3

  重启 Apache 后查看 error.log，可追踪每条规则的匹配与执行过程。

• PHP 路由解析示例（index.php）：

  <?php
  $url = $_GET['url'] ?? '';
  // 安全过滤：移除开头/结尾斜杠，防止路径遍历
  $url = trim($url, '/');
  $segments = explode('/', $url); // ['en', 'about']
  // 后续路由分发逻辑...

• Windows 用户注意：
  若使用 WAMP/XAMPP，请确认 httpd.conf 中 LoadModule rewrite_module modules/mod_rewrite.so 已取消注释，且 AllowOverride All 在对应 块中生效。

• Nginx 迁移提示：
  若未来迁移到 Nginx，等效配置为：

  location / {
      try_files $uri $uri/ /index.php?url=$uri&$args;
  }

遵循以上配置，您的嵌套路由将稳定工作：点击 domain.local/en/about 将正确触发 index.php，$_GET['url'] 值为 en/about，静态资源毫发无损，且彻底规避重写循环与路径错配陷阱。

到这里，我们也就讲完了《Apache2.htaccess重写失败解决方法》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！