PimCore X无法加载：安装后页面及管理端404问题求助

1. 启用Apache URL重写模块并验证配置 #

PimCore的路由依赖mod_rewrite模块，先确认模块已启用：

sudo a2enmod rewrite
sudo systemctl restart apache2

检查站点配置文件（路径通常为/etc/apache2/sites-available/[你的站点名].conf），确保Directory块包含正确的重写规则：

<Directory /var/www/pimcore/public>
    Options Indexes FollowSymLinks MultiViews
    AllowOverride All
    Require all granted

    RewriteEngine On
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteRule ^(.*)$ index.php [QSA,L]
</Directory>

修改后重启Apache：

sudo systemctl restart apache2

2. 检查public目录下的.htaccess文件 #

确认/var/www/pimcore/public目录存在.htaccess文件，内容需包含：

RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^ index.php [L]

若文件缺失，手动创建并设置权限：

sudo chown www-data:www-data /var/www/pimcore/public/.htaccess
sudo chmod 644 /var/www/pimcore/public/.htaccess

3. 修复项目目录权限 #

确保Apache用户拥有足够的读写权限：

sudo chown -R www-data:www-data /var/www/pimcore
sudo chmod -R 755 /var/www/pimcore
sudo chmod -R 775 /var/www/pimcore/var /var/www/pimcore/public/assets

4. 清除缓存并重新生成路由规则 #

进入项目目录执行命令：

cd /var/www/pimcore
sudo -u www-data php bin/console cache:clear
sudo -u www-data php bin/console pimcore:cache:clear
sudo -u www-data php bin/console router:dump-apache -o public/.htaccess

完成后再次重启Apache。

5. 确认DocumentRoot指向正确 #

检查站点配置中的DocumentRoot必须指向PimCore的public子目录，而非项目根目录：

DocumentRoot /var/www/pimcore/public

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