安装插件后部分图片变为仅带宽高的灰色块,如何重新生成图片?
异常图片的排查与修复方法
先做基础排查,别上来就乱刷缓存
- 直接访问异常图片的原始直链,比如示例的
domain.com/pub/media/wysiwyg/banner/id-20-cat-4.jpg,如果直链都返回403、404或者空白,就不是前端渲染出的灰色占位问题,要先从后端找原因 - 登录服务器核对
pub/media/wysiwyg/对应子目录下的物理文件是不是真的存在,排除插件迁移媒体文件时漏读、漏写导致的文件丢失 - 翻一遍刚装的那几个插件的设置项,重点看SEO路径重写、页面缓存、CDN接入、安全防爬、图片优化类功能,这类改动是部分图片触发占位异常的最高发原因,基本能覆盖80%以上的同类问题
按实际场景对应修复
- 文件本身存在,只是权限、缓存触发的占位异常
- 把媒体目录的权限重置到系统要求的标准值:
pub/media目录设755权限,目录下所有文件设644权限,排除插件擅自修改目录权限导致服务器无法读取图片的问题 - 依次清掉站点全量缓存、浏览器本地缓存、CDN节点缓存,再刷新页面验证
- 把媒体目录的权限重置到系统要求的标准值:
- 基于Magento架构的站点(对应wysiwyg媒体路径的系统)的媒体缓存生成异常
- 执行系统内置的媒体刷新命令重建缓存:
- 重新生成前端引用的多尺寸媒体缓存:
php bin/magento catalog:images:resize - 刷新wysiwyg目录的媒体访问索引:
php bin/magento media:html-upload
- 重新生成前端引用的多尺寸媒体缓存:
- 如果是插件自带的自动转WebP、图片压缩功能触发的异常,先临时关掉这类功能,再重新跑上面的命令验证效果
- 执行系统内置的媒体刷新命令重建缓存:
- 防盗链误拦截触发的占位异常
很多安全类插件会自动开启媒体目录的防盗链校验,只要图片的引用来源不在白名单里,就会返回无图的灰色占位块。这类问题直接把
pub/media/wysiwyg/目录加到防盗链白名单,跳过这个目录的来源校验就行。
内容的提问来源于stack exchange,提问作者emerika
相关产品推荐
相关产品推荐

