AEM中asset.listRenditions()为何仅返回静态Renditions而非动态Renditions？

问题原因 #

Dynamic renditions是按需生成的，并不会持久化存储在JCR节点中，而asset.listRenditions()方法的设计逻辑是仅返回存储在JCR里的静态renditions和原始资产文件，所以默认情况下拿不到动态renditions。

解决方案 #

1. 使用AssetRenditionPicker服务获取所有Renditions

这是AEM官方推荐的获取包含动态renditions在内的所有可用 renditions的方式，它会自动识别配置好的动态规则：

import com.adobe.cq.dam.api.Asset;
import com.adobe.cq.dam.api.renditions.AssetRendition;
import com.adobe.cq.dam.api.renditions.AssetRenditionPicker;
import org.osgi.service.component.annotations.Reference;
import java.util.List;

// 在你的组件/服务中注入AssetRenditionPicker
@Reference
private AssetRenditionPicker renditionPicker;

public List<AssetRendition> getAllAvailableRenditions(Asset asset) {
    // 传入asset对象，null参数表示获取所有类型的renditions
    return renditionPicker.getRenditions(asset, null, null);
}

2. 手动构建动态Rendition的访问URL

如果只需要动态rendition的访问路径而非AssetRendition对象，可以直接通过资产路径拼接动态rendition的格式：

public String getDynamicRenditionUrl(Asset asset) {
    // 示例：生成1280x720尺寸的jpeg格式动态rendition
    return asset.getPath() + ".rendition.1280x720.jpeg";
}

注意：这里的格式要和你在AEM图像配置文件（Image Profile）中定义的动态规则匹配。

3. 检查AEM配置有效性

• 确认资产对应的图像配置文件已正确配置动态rendition规则（比如目标尺寸、输出格式）；
• 如果依赖Dynamic Media功能，确保该功能已在实例中启用并配置完成。

额外说明 #

• listRenditions()仅返回持久化的静态资源，这是方法的固有逻辑，无法通过参数修改；
• 若需要获取动态rendition的元数据（如尺寸、格式），可以使用renditionPicker.getRenditionInfo(asset)方法，无需实际生成rendition文件。

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