Apache虚拟主机指向HTDOCS外时Laravel路由失效问题

嘿，我帮你分析下这个问题——当虚拟主机指向HTDOCS外的Laravel项目时，只有根路径能访问，其他API路由全挂，放在HTDOCS里就正常，这大概率是Apache的权限、虚拟主机配置或者重写规则的问题，咱们一步步来排查：

1. 确保Apache有权访问外部目录 #

Apache默认对HTDOCS外的目录会有访问限制，你需要在httpd.conf（或者对应站点的配置文件）里给你的Laravel项目目录添加权限配置：

<Directory "/absolute/path/to/your/laravel/project">
    Options Indexes FollowSymLinks MultiViews
    AllowOverride All  # 关键：允许.htaccess规则生效
    Require all granted
</Directory>

注意这里的路径必须是绝对路径，配置完记得重启Apache。

2. 检查虚拟主机的DocumentRoot是否指向public目录 #

Laravel的入口文件是public/index.php，很多人容易把虚拟主机的DocumentRoot指向项目根目录，这会直接导致路由失效。正确的虚拟主机配置应该是：

<VirtualHost *:80>
    ServerName project-outside.dev
    # 必须指向Laravel的public子目录
    DocumentRoot "/absolute/path/to/your/laravel/project/public"
    
    <Directory "/absolute/path/to/your/laravel/project/public">
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>

配置后重启Apache，再测试路由。

3. 确认public目录下的.htaccess配置正确 #

Laravel的public/.htaccess负责路由重写，要是这个文件缺失或者配置错误，非根路径肯定访问不了。确保你的.htaccess是官方默认配置：

<IfModule mod_rewrite.c>
    <IfModule mod_negotiation.c>
        Options -MultiViews -Indexes
    </IfModule>

    RewriteEngine On

    # 处理Authorization请求头
    RewriteCond %{HTTP:Authorization} .
    RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]

    # 移除URL末尾的斜杠
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteCond %{REQUEST_URI} (.+)/$
    RewriteRule ^ %1 [L,R=301]

    # 所有请求转发到index.php
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteRule ^ index.php [L]
</IfModule>

如果文件不存在，直接从Laravel官方仓库复制一份即可。

4. 启用Apache的mod_rewrite模块 #

路由重写完全依赖mod_rewrite模块，要是没启用，.htaccess的规则根本不会生效：

• Linux系统：执行命令sudo a2enmod rewrite，然后重启Apache（sudo systemctl restart apache2）
• Windows系统：打开httpd.conf，找到LoadModule rewrite_module modules/mod_rewrite.so这一行，去掉前面的注释符号#，然后重启Apache服务。

5. 修复Laravel目录权限 #

Apache需要读写Laravel的storage和bootstrap/cache目录来生成缓存和日志，权限不足也可能导致路由异常：

# 把目录所有者改成Apache用户（比如www-data）
sudo chown -R www-data:www-data /path/to/your/laravel/project
# 设置目录权限
sudo chmod -R 755 /path/to/your/laravel/project/storage
sudo chmod -R 755 /path/to/your/laravel/project/bootstrap/cache

按上面的步骤逐一排查，应该就能解决非根路由失效的问题啦！

内容的提问来源于stack exchange，提问作者Victor Ferreira