Magento2安装后出现空白页面及CSS、JS无法加载问题

一、解决空白页问题 #

1. 开启错误提示定位根源
   临时在Magento根目录的index.php顶部添加以下代码，直接显示错误信息：

   ini_set('display_errors', 1);
   error_reporting(E_ALL);
   

   同时检查关键日志：

   • Magento错误日志：var/log/exception.log、var/log/system.log
   • Apache错误日志：/var/log/apache2/error.log

2. 修复文件权限与所有权
   Ubuntu下Apache运行用户为www-data，确保Magento目录权限正确：

   # 设置目录所有权
   sudo chown -R www-data:www-data /path/to/your/magento2
   # 设置文件和目录基础权限
   sudo find /path/to/your/magento2 -type f -exec chmod 644 {} \;
   sudo find /path/to/your/magento2 -type d -exec chmod 755 {} \;
   # 给核心可写目录开放权限
   sudo chmod -R 777 var/ pub/ generated/
   

3. 启用Apache重写模块并配置AllowOverride

   # 启用rewrite模块
   sudo a2enmod rewrite
   # 重启Apache生效
   sudo systemctl restart apache2
   

   编辑Apache站点配置文件（比如/etc/apache2/sites-available/000-default.conf），确保Magento目录的Directory块设置：

   <Directory /var/www/html/magento2>
       Options Indexes FollowSymLinks MultiViews
       AllowOverride All
       Require all granted
   </Directory>
   

   修改后再次重启Apache。

二、解决CSS/JS资源无法加载问题 #

1. 手动部署静态资源
   克隆的代码通常不包含预生成的静态资源，执行部署命令：

   # 生产模式强制部署（-f参数覆盖现有文件）
   php bin/magento setup:static-content:deploy -f
   # 开发模式可启用符号链接，避免重复部署
   php bin/magento deploy:mode:set developer
   php bin/magento dev:source-theme:deploy
   

2. 确保pub/static目录权限正确
   静态资源目录需要Apache用户可读写：

   sudo chown -R www-data:www-data pub/static/
   sudo chmod -R 777 pub/static/
   

3. 清除Magento缓存
   部署完成后强制清除缓存：

   php bin/magento cache:flush
   php bin/magento cache:clean
   

4. 检查pub/static/.htaccess文件
   该文件负责静态资源的访问规则，如果缺失，从Magento官方代码库复制对应文件到pub/static/目录。

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