OpenCart子目录形式多店铺URL访问404问题排查

核心问题分析 #

你的404错误主要来自两个关键原因：

1. 物理目录冲突：若服务器网站根目录下存在second实际文件夹，Apache会优先尝试访问该目录，而非将请求转发到OpenCart的index.php处理。
2. .htaccess规则未适配：默认重写规则无法识别/second/路径对应的店铺实例，导致请求无法正确路由到对应店铺的业务逻辑。

解决步骤 #

1. 删除物理目录（若存在） #

检查服务器网站根目录，若发现second文件夹，直接删除——OpenCart子目录店铺无需物理目录，完全通过路由映射实现。

2. 修改.htaccess重写规则 #

在现有.htaccess的RewriteBase /之后，新增子目录店铺的专属规则，并调整默认规则避免冲突：

# SEO URL Settings
RewriteEngine On
# If your opencart installation does not run on the main web folder make sure you folder it does run in ie. / becomes /shop/

RewriteBase / 

# 新增：处理子目录多店铺请求（替换store_id为你的实际店铺ID）
RewriteCond %{REQUEST_URI} ^/second/
RewriteRule ^second/(.*)$ index.php?_route_=$1&store_id=2 [L,QSA]

RewriteRule ^sitemap.xml$ index.php?route=extension/feed/google_sitemap [L]
RewriteRule ^googlebase.xml$ index.php?route=extension/feed/google_base [L]
RewriteRule ^system/storage/(.*) index.php?route=error/not_found [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_URI} !.*\.(ico|gif|jpg|jpeg|png|js|css)
# 修改：排除/second/路径，避免和专属规则冲突
RewriteRule ^(?!second/)([^?]*) index.php?_route_=$1 [L,QSA]

注意：store_id=2需替换为你后台新增店铺的实际ID——可在OpenCart后台【系统】>【店铺】页面查看，默认第一个额外店铺的ID为2，默认店铺ID为1。

3. 验证后台多店铺配置 #

确保新增店铺的后台配置无误：

• 进入【系统】>【店铺】，编辑目标店铺
• URL字段填写：https://test-opencart-php74-mc.test.net/second/（必须以斜杠结尾）
• Secure URL字段填写相同的HTTPS地址
• 确认店铺Status设置为Enabled

4. 清除系统缓存 #

修改配置后，进入OpenCart后台【系统】>【维护】>【缓存】，点击“清除”按钮，确保缓存更新生效。

补充说明 #

OpenCart文档提及的子域名模式仅为推荐方案，子目录模式完全支持，只要配置正确即可正常运行。若修改后仍有问题，可检查：

• Apache的mod_rewrite模块是否已启用
• 服务器虚拟主机配置中是否设置了AllowOverride All（允许.htaccess覆盖配置）

内容的提问来源于stack exchange，提问作者Xavier Issac