Symfony5.4配置LiipImagine后图片404无缓存目录问题求助

• 运行环境：Symfony 5.4 框架，安装 liip imagine 扩展用于图片处理
• 故障表现：配置完成后浏览器无法正常显示图片，开发者工具查看到图片请求地址 http://localhost:8000/media/cache/resolve/my_thumb/images/properties/629a464aa81ef086062845.jpg 返回404 Not Found错误；项目images目录下未自动生成media/cache相关目录结构
• 已尝试方案：手动添加resolver、loaders相关配置，问题未解决

liip_imagine.yaml 配置内容 #

liip_imagine:
    # 可用驱动选项: "gd" / "gmagick" / "imagick"
    driver: "gd"

    filter_sets:
        cache : ~
        my_thumb:
            quality: 75
            filters:
                thumbnails: {size: [360, 230], mode: outbound}

Twig模板图片渲染代码 #

<img src="{{ vich_uploader_asset(property, 'imageFile') | imagine_filter('my_thumb') }}" class="card-img-top" alt="">

按以下顺序排查操作即可解决问题：

• 先确认扩展路由是否正常加载，执行命令 php bin/console debug:router | grep liipimagine，正常输出应包含liip_imagine_filter相关路由条目；如果没有，先执行php bin/console cache:clear清除项目缓存再重新检查
• 检查public目录权限，确保PHP运行进程的用户对项目public/目录有写入权限，否则扩展无法自动创建缓存目录、生成缩略图。Linux/macOS环境可执行chmod -R 755 public/，并将目录所有者修改为PHP运行用户（常见为www-data、nginx、你的本地登录用户，根据实际环境调整）
• 修正配置错误：当前配置中filter_sets节点下的cache : ~为无效配置，直接删除该行，同时补全默认的解析器、加载器配置，修正后的参考配置如下：

liip_imagine:
    driver: "gd"
    # 本地文件存储用这个加载器
    data_loader: liip_imagine.data_loader.file_system
    resolvers:
        default:
            web_path:
                web_root: '%kernel.project_dir%/public'
                cache_prefix: media/cache
    filter_sets:
        my_thumb:
            quality: 75
            filters:
                thumbnails: {size: [360, 230], mode: outbound}

• 本地开发环境启动服务时，要将站点根目录指向public目录，启动命令可使用symfony server:start，或原生PHP命令php -S localhost:8000 -t public，避免路由被静态资源规则拦截
• 配置修改完成后，可先手动执行命令生成缩略图验证配置有效性：php bin/console liip:imagine:cache:resolve images/properties/629a464aa81ef086062845.jpg --filters=my_thumb，执行完成后检查public/media/cache/my_thumb/目录下是否存在对应缩略图，文件存在的情况下刷新页面即可正常加载
• 如果以上操作完成后仍返回404，检查VichUploader配置，确认vich_uploader_asset助手函数返回的原始图片路径真实存在，原始资源缺失时LiipImagine无法生成缩略图，会直接返回404状态码

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