商品原图存在，但前台缓存尺寸返回 404，先确认源文件在 pub/media/catalog/product 中能被部署用户读取。文件名大小写在 Linux 上敏感，数据库路径与实际文件大小写不一致时，本地开发可能正常、生产却失败。

检查 PHP 的 GD 或 Imagick 扩展、内存限制和 Magento 日志。某一张图片失败时，通常是源文件损坏、颜色空间或尺寸异常；所有图片都失败则更像目录权限、媒体存储或 Base Media URL 配置。

bin/magento catalog:images:resize

批量预生成可以暴露具体失败文件，但大目录应在维护窗口执行。清理图片缓存后，首次请求需要重新生成，不能在高流量时直接删除全部缓存而没有预热。

使用远程存储、CDN 或只读发布目录时，还要确认生成节点能写缓存且其他节点能读取。修复权限时遵循部署用户和 Web 用户的共享策略，不要简单把 media 目录设为 777。