Apache .htaccess多环境适配：动态设置RewriteBase问题

我懂你现在的困扰——要让同一个.htaccess文件同时适配根目录部署的生产环境，和带/app/子目录的本地环境，还不想硬编码RewriteBase。你尝试的动态获取BASE的规则本身是对的，但问题大概率出在规则的执行顺序和后续规则对环境变量的引用方式上。

核心问题分析 #

你之前的动态BASE规则可能被放在了其他RewriteRule之后，导致环境变量BASE还没被初始化就被后续规则引用了；另外，后续的RewriteRule没有正确结合BASE环境变量来匹配请求路径，所以本地环境中/app/admin_cms/...这类路径无法被后台规则捕获。

修正后的完整.htaccess配置 #

下面是适配两个环境的最终配置，我会逐段解释：

Options -Indexes
RewriteEngine On

# 第一步：动态获取当前部署的BASE路径（必须放在所有RewriteRule之前）
# 原理：通过对比REQUEST_URI和RewriteRule匹配的路径，提取共同前缀作为BASE
RewriteCond %{REQUEST_URI}::$1 ^(.*?/)(.*)::\2$
RewriteRule ^(.*)$ - [E=BASE:%1]

# 强制HTTPS跳转（无需修改，适配所有环境）
RewriteCond %{HTTPS} off
RewriteRule ^(.*)$ https://%{HTTP_HOST}%{REQUEST_URI} [L,R=301]

# HTML结尾URL规则：结合BASE匹配路径
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^%{ENV:BASE}(.*)\.html$ index.php?rt=$1&%{QUERY_STRING} [L,QSA]

# 后台环境规则：结合BASE匹配路径并排除静态资源
RewriteCond %{REQUEST_URI} !^%{ENV:BASE}admin_cms/.*\.(jpe?g|css|js|gif|png|woff2?|ttf|ico)$ [NC]
RewriteRule ^%{ENV:BASE}admin_cms/?(.*)$ admin.php?rt=$1&%{QUERY_STRING} [L,QSA]

关键修正点说明 #

1. 动态BASE规则的位置
   必须把这条规则放在RewriteEngine On之后、所有其他RewriteRule之前，这样才能确保BASE环境变量在后续规则执行前被正确初始化。本地环境下它会捕获/app/作为BASE，生产环境则捕获/。

2. 规则中引用BASE环境变量
   所有需要匹配请求路径的规则（HTML规则、后台规则）都要在匹配模式前加上%{ENV:BASE}：

   • 本地环境中，^%{ENV:BASE}admin_cms/?(.*)$会匹配/app/admin_cms/xxx这类路径
   • 生产环境中则匹配/admin_cms/xxx，完美适配两种部署方式

3. 静态资源排除规则的调整
   后台的静态资源排除条件也要加上%{ENV:BASE}前缀，确保本地环境中/app/admin_cms/xxx.css这类静态资源不会被转发到admin.php。

测试验证方法 #

如果你想确认BASE环境变量是否正确设置，可以临时添加一条测试规则：

# 临时测试：访问/test路径查看BASE值
RewriteRule ^test$ - [E=TEST:%{ENV:BASE},R]

本地环境访问https://example.dev.local/app/test，跳转后的URL会显示TEST=/app/；生产环境访问https://example.com/test则显示TEST=/，说明BASE已正确获取。

额外注意事项 #

• 确保你的Apache服务器已开启mod_rewrite模块
• 服务器配置中对应目录的AllowOverride设置为All，否则.htaccess文件不会生效

内容的提问来源于stack exchange，提问作者eL-Prova