FilamentPHP v2在Apache服务器登录异常：空白页+控制台JSON语法错误

核心原因 #

控制台的错误提示说明前端发起的登录API请求，后端返回的不是预期的JSON数据，而是HTML页面（比如首页或404页面）。这通常是Apache的URL重写规则未正确配置，导致Laravel的路由无法被正确解析，API请求被错误路由到静态HTML页面。

修复步骤 #

1. 启用Apache的mod_rewrite模块 #

• 执行命令开启模块：

  sudo a2enmod rewrite
  

• 重启Apache服务：

  sudo systemctl restart apache2
  

2. 配置项目public目录的.htaccess文件 #

确保项目public文件夹下有正确的.htaccess规则，内容如下：

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

    RewriteEngine On

    # 处理授权请求头
    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>

3. 修改Apache虚拟主机配置 #

编辑虚拟主机配置文件（通常在/etc/apache2/sites-available/目录下），确保AllowOverride设置为All，让.htaccess规则生效：

<VirtualHost *:80>
    ServerName your-domain.com
    DocumentRoot /var/www/your-project/public

    <Directory /var/www/your-project/public>
        AllowOverride All
        Require all granted
    </Directory>

    ErrorLog ${APACHE_LOG_DIR}/your-project-error.log
    CustomLog ${APACHE_LOG_DIR}/your-project-access.log combined
</VirtualHost>

修改后重启Apache：

sudo systemctl restart apache2

4. 清除Laravel缓存 #

执行命令清除应用缓存，确保路由和配置更新：

php artisan cache:clear
php artisan route:clear
php artisan config:clear

5. 检查文件权限 #

确保Apache进程对项目目录有读写权限：

sudo chown -R www-data:www-data /var/www/your-project
sudo chmod -R 755 /var/www/your-project
sudo chmod -R 775 /var/www/your-project/storage /var/www/your-project/bootstrap/cache

验证修复 #

完成上述操作后，刷新登录页面，检查控制台是否还有JSON解析错误，尝试登录操作，确认是否能正常进入后台面板。

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