如何改写.htaccess规则实现资源URL映射、入口文件跳转及排查404问题？

咱们一步步来拆解你的问题，先理清楚需求、现有配置问题，再逐个解答疑问：

• 项目入口必须为./public/index.php，访问网站根域名时需跳转至该入口文件；
• HTML页面中通过/css/index.css引用的CSS文件，实际存储路径是./resources/styles/index.css，需确保这类URL能正确访问到资源并在页面中生效。

public/
├─ .htaccess
├─ index.php
resources/
├─ styles/
│ ├─ index.css
│ ├─ main.css
.htaccess

我尝试使用根目录下的如下.htaccess配置，但访问时返回404错误：

RewriteEngine on
RewriteBase /
RewriteCond %{REQUEST_URI} /resources/styles/.*
RewriteRule ^resources/styles/(.*)$ /css/$1 [QSA,L]
RewriteRule ^$ public/ [L]
RewriteRule (.*) public/$1 [L]

public目录下的.htaccess配置为：

RewriteEngine On
# RewriteBase /
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^ index.php [QSA,L]

1. 现有根目录.htaccess配置缺失了什么导致404？请尽可能详细说明；
2. 如何通过.htaccess实现对js、fonts、images类资源的同样URL映射处理？
3. 我了解可通过Apache配置实现该需求，如下是我的配置，请指出是否存在缺失：

...
Alias /css "/var/www/html/resources/styles"
<Directory /var/www/html/resources/styles>
    Options FollowSymLinks
    AllowOverride None
    Require all granted
</Directory>
...

当前我需要通过.htaccess文件实现上述需求，而非Apache主配置。

1. 根目录.htaccess导致404的核心原因 #

你的现有配置逻辑完全搞反了，还存在规则顺序错误：

• 规则方向错误：目前的规则是把请求/resources/styles/xxx重写到/css/xxx，但实际我们需要的是「当用户请求/css/xxx时，去匹配resources/styles/xxx这个真实文件」；
• 规则顺序错误：后面的两条规则会把所有请求（包括/css/xxx）都转发到public/目录下，这就导致/css/index.css会被重写成public/css/index.css——而这个文件根本不存在，自然返回404；
• 冗余条件：RewriteCond %{REQUEST_URI} /resources/styles/.*这个条件完全没必要，因为我们要处理的是外部用户请求的/css/路径，不是内部的resources/styles/路径。

2. 扩展到js、fonts、images等资源的配置 #

我们可以在根目录的.htaccess中添加一组前置规则，统一处理不同类型的资源映射，每个资源类型对应一个URL前缀和真实路径：

# 处理CSS资源：/css/xxx → resources/styles/xxx
RewriteRule ^css/(.*)$ resources/styles/$1 [L]

# 处理JS资源：/js/xxx → resources/scripts/xxx（替换成你项目的真实JS路径）
RewriteRule ^js/(.*)$ resources/scripts/$1 [L]

# 处理字体资源：/fonts/xxx → resources/fonts/xxx
RewriteRule ^fonts/(.*)$ resources/fonts/$1 [L]

# 处理图片资源：/images/xxx → resources/images/xxx
RewriteRule ^images/(.*)$ resources/images/$1 [L]

注意事项： #

• 这些规则必须放在转发到public目录的规则之前，否则资源请求会先被转发到public，映射规则根本不会生效；
• [L]标记表示这条规则匹配后就停止后续规则，避免资源请求被错误转发到public目录；
• 如果你项目的真实资源路径和示例不同，直接替换成对应路径即可。

3. 你的Apache主配置是否有缺失？ #

你的Apache主配置的Alias和Directory块基本没问题，细节上可以确认几点：

• 如果项目根目录确实是/var/www/html，那么Alias /css "/var/www/html/resources/styles"是正确的；
• Options FollowSymLinks确保符号链接能被正常访问，没问题；
• AllowOverride None在Directory块里是合理的，因为我们不需要在resources/styles目录下启用.htaccess；
• Require all granted确保所有用户都能访问这些资源，没问题。

不过既然你需要用.htaccess实现，这个主配置可以暂时不用，专注调整根目录的.htaccess即可。

把上面的修正整合起来，最终的根目录.htaccess应该是这样：

RewriteEngine on
RewriteBase /

# 资源映射规则：放在最前面，优先匹配
RewriteRule ^css/(.*)$ resources/styles/$1 [L]
RewriteRule ^js/(.*)$ resources/scripts/$1 [L]
RewriteRule ^fonts/(.*)$ resources/fonts/$1 [L]
RewriteRule ^images/(.*)$ resources/images/$1 [L]

# 根目录请求直接转发到public/index.php
RewriteRule ^$ public/index.php [L]

# 其他请求转发到public目录下处理
RewriteRule (.*) public/$1 [L]

public目录下的.htaccess可以保持不变，它负责把public目录下的非文件/非目录请求转发到index.php，适合路由驱动的项目或单页应用。

内容的提问来源于stack exchange，提问作者Utmost Creator