Magento 2迁移Apache文档根至pub目录后资源加载失败求助

我之前也遇到过一模一样的问题！把Magento 2根目录迁移到pub后，图片和合并CSS加载失败，明明pub/static里对应的文件都存在，折腾了好一阵才搞定，给你几个排查和解决的步骤：

1. 先搞定权限问题（最常见的坑） #

Magento对文件权限要求很严格，尤其是pub目录下的静态资源文件夹，必须让web服务器用户拥有读写权限。执行以下命令（注意：如果你的web用户不是www-data，比如CentOS是apache，要替换成对应的用户组）：

# 递归设置所属用户组
sudo chown -R www-data:www-data /var/www/html/magento2
# 设置文件和目录的基础权限
sudo find /var/www/html/magento2 -type f -exec chmod 644 {} \;
sudo find /var/www/html/magento2 -type d -exec chmod 755 {} \;
# 给静态资源目录添加写入权限
sudo chmod -R g+w /var/www/html/magento2/pub/static /var/www/html/magento2/pub/media

2. 重新部署静态资源（针对生产模式） #

如果你的Magento是生产模式，静态资源不会实时生成，必须手动部署。先确认当前模式：

bin/magento deploy:mode:show

如果显示是生产模式，执行强制部署命令（-f参数覆盖现有文件）：

bin/magento setup:static-content:deploy -f

要是是开发者模式，只需要清理缓存就行：

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

3. 检查pub目录下的.htaccess文件 #

pub目录自带的.htaccess是处理静态资源重写的核心，如果迁移时不小心弄丢了或者权限不对，就会导致资源加载失败。可以从Magento源码里复制一份：

sudo cp /var/www/html/magento2/vendor/magento/magento2-base/pub/.htaccess /var/www/html/magento2/pub/
# 设置正确的权限
sudo chown www-data:www-data /var/www/html/magento2/pub/.htaccess
sudo chmod 644 /var/www/html/magento2/pub/.htaccess

另外，别忘了确保Apache开启了rewrite模块：

sudo a2enmod rewrite
sudo systemctl restart apache2

4. 清理静态资源缓存和浏览器缓存 #

有时候旧的缓存路径会残存在pub/static里，手动清理一下（保留.htaccess和requirejs-config.js）：

rm -rf /var/www/html/magento2/pub/static/frontend/* /var/www/html/magento2/pub/static/adminhtml/*

然后重新部署静态资源，同时用Ctrl+Shift+R强制刷新浏览器，避免浏览器加载旧的缓存文件。

5. 检查Apache虚拟主机的AllowOverride设置 #

在你的Apache虚拟主机配置里，一定要给pub目录加上AllowOverride All，否则.htaccess里的规则不会生效。修改后的配置应该类似：

DocumentRoot /var/www/html/magento2/pub
ServerName www.somedomainorother.co.uk
ServerAlias somedomainorother.co.uk

<Directory /var/www/html/magento2/pub>
    AllowOverride All
    Require all granted
</Directory>

修改后重启Apache：

sudo systemctl restart apache2

按照这些步骤走下来，基本就能解决静态资源加载的问题了，我当时就是权限和.htaccess的问题导致的。

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