Alfresco下Java代码无法转文档为PDF，但网页渲染正常的问题

问题说明 #

可通过http://localhost:8090的Alfresco界面将docx文档转换为PDF，但使用Java代码实现时失败，目标是实现任意文档（当前测试docx）转PDF功能。

原代码 #

@Override
protected void executeImpl(Action action, NodeRef actionedUponNodeRef) {
    CopyService copyService =serviceRegistry.getCopyService();
    NodeService nodeService =serviceRegistry.getNodeService();
    RenditionService2 renditionService2 =serviceRegistry.getRenditionService2();
    NodeRef newUponNodeRef = copyService.copy(actionedUponNodeRef, nodeService.getPrimaryParent(actionedUponNodeRef).getParentRef(),nodeService.getPrimaryParent(actionedUponNodeRef).getTypeQName(),nodeService.getPrimaryParent(actionedUponNodeRef).getQName());
    TransformDefinition transformationDefinition = new TransformDefinition(Mimetype.MIMETYPE_PDF, null, null, null, null);
    renditionService2.render(newUponNodeRef, transformationDefinition);
        
}

错误日志 #

docker-cd-ged-mar-acs-1       |  2022-11-21 15:24:40,207  ERROR [content.transform.LocalTransformServiceRegistry] [QuartzScheduler_Worker-1] Transformer "outlookMsgToLibreofficeViaText" references the transformOptions (tikaOptions) which do not exist. Read from resource alfresco/transforms/0100-basePipelines.json
docker-cd-ged-mar-acs-1       |  2022-11-21 15:24:40,207  ERROR [content.transform.LocalTransformServiceRegistry] [QuartzScheduler_Worker-1] Transformer "htmlToImageViaTXT" references the transformOptions (pdfRendererOptions) which do not exist. Read from resource alfresco/transforms/0100-basePipelines.json
docker-cd-ged-mar-acs-1       |  2022-11-21 15:25:50,251  ERROR [content.transform.LocalTransformServiceRegistry] [QuartzScheduler_Worker-1] Transformer "textToImageViaPdf" references the transformOptions (pdfRendererOptions) which do not exist. Read from resource alfresco/transforms/0100-basePipelines.json

问题分析 #

1. 日志错误无关性：日志中报错的转换器（如outlookMsgToLibreofficeViaText）与docx转PDF无关，属于系统其他转换管道的配置小问题，不影响核心功能，可忽略。
2. 代码逻辑问题：
   • 多余的节点复制操作：复制节点不仅没必要，还可能因节点属性/内容未正确继承导致转换失败。
   • 手动构建TransformDefinition未使用系统预设的PDF转换规则，缺少必要的转换参数，导致转换服务无法匹配到正确的转换器（如LibreOffice，Alfresco默认用它处理docx转PDF）。

修正代码 #

使用Alfresco预设的pdf renditions定义，触发系统默认的PDF转换流程，无需手动构建转换规则：

@Override
protected void executeImpl(Action action, NodeRef actionedUponNodeRef) {
    // 获取标准RenditionService
    RenditionService renditionService = serviceRegistry.getRenditionService();
    // 创建系统预设的PDF转换定义
    RenditionDefinition pdfRenditionDef = renditionService.createRenditionDefinition("pdf");
    // 执行转换
    renditionService.render(actionedUponNodeRef, pdfRenditionDef);
}

如果必须使用RenditionService2，需确保指定正确的源MIME类型及转换参数，示例如下：

@Override
protected void executeImpl(Action action, NodeRef actionedUponNodeRef) {
    NodeService nodeService = serviceRegistry.getNodeService();
    RenditionService2 renditionService2 = serviceRegistry.getRenditionService2();
    
    // 获取源文档的MIME类型
    String sourceMimeType = (String) nodeService.getProperty(actionedUponNodeRef, ContentModel.PROP_CONTENT_MIME_TYPE);
    
    // 构建包含源类型的转换定义
    TransformDefinition transformationDefinition = new TransformDefinition(
        Mimetype.MIMETYPE_PDF, 
        sourceMimeType, 
        null, 
        Collections.emptyMap(), 
        null
    );
    
    // 直接转换原节点（无需复制）
    renditionService2.render(actionedUponNodeRef, transformationDefinition);
}

关键说明 #

• 优先使用系统预设的rendition定义（如pdf），Alfresco会自动匹配最优转换器，避免手动配置的遗漏。
• 若需自定义转换参数（如页面大小、水印等），可通过RenditionDefinition的setParameter方法添加，无需从头构建TransformDefinition。

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