Magento 2静态文件路径错误（应为pub/static/而非static/）修复求助

• 确认服务器根目录指向pub文件夹
  Magento官方要求网站根目录必须设置为magento/pub而非项目根目录，这是导致静态资源路径错误的核心原因之一：

  • Apache：修改虚拟主机配置，将DocumentRoot改为/path/to/your/magento/pub，执行sudo systemctl restart apache2重启服务。
  • Nginx：修改server块内的root参数为/path/to/your/magento/pub，执行sudo systemctl restart nginx重启服务。

• 重新部署静态资源
  即使文件存在，也可能因部署缓存或符号链接异常导致路径错误，执行以下命令修复：

  php bin/magento setup:static-content:deploy -f
  php bin/magento cache:flush
  php bin/magento cache:clean
  

  -f参数用于强制部署，适配开发环境场景。

• 验证Apache重写模块配置
  若使用Apache，确保重写模块正常生效：

  1. 启用模块：sudo a2enmod rewrite
  2. 重启Apache：sudo systemctl restart apache2
  3. 确认项目根目录和pub目录下的.htaccess文件未被篡改，若自定义过可恢复Magento默认的.htaccess内容。

• 修正Magento基础URL配置
  检查并调整系统基础URL，确保包含pub路径：

  • 命令行修改（本地环境示例）：

    php bin/magento config:set web/unsecure/base_url http://localhost/magento/pub/
    php bin/magento config:set web/secure/base_url https://localhost/magento/pub/
    

  • 执行后务必清理缓存。

• 检查pub/static目录权限
  确保web服务器用户（通常为www-data）拥有该目录的读写权限：

  sudo chown -R www-data:www-data /path/to/your/magento/pub/static
  sudo chmod -R 775 /path/to/your/magento/pub/static
  

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