AEM 6.x中ReplicationActionType.DELETE复制操作失效问题求助

这问题我之前帮不少人排查过，结合AEM的复制（Replication）机制和你提到的工作流场景，大概率是这几个原因导致的：

1. 删除操作未触发复制事件 #

AEM的Author到Publisher的同步完全依赖复制队列，如果你只是在代码里用JCR API或者资源解析器删除了文件夹，默认不会自动触发删除动作的复制请求。工作流里的操作除非显式调用复制服务，否则Publisher完全不知道Author上删了东西。

• 排查&修复：检查你的代码是否在删除文件夹后，调用了Replicator服务的replicate方法，并且指定ReplicationActionType.DELETE类型。示例代码如下：

  import com.day.cq.replication.ReplicationActionType;
  import com.day.cq.replication.Replicator;
  
  // 注入Replicator服务
  @Reference
  private Replicator replicator;
  
  // 删除文件夹后触发同步删除
  replicator.replicate(workflowSession.getSession(), ReplicationActionType.DELETE, "/path/to/your/target/folder");
  

2. 复制队列阻塞或请求失败 #

即使你触发了删除的复制请求，也可能因为代理配置问题、权限不足或网络问题导致请求没成功发到Publisher。

• 排查点：
  • 登录Author实例的/crx/de，查看默认发布代理/var/replication/agents.author/publish的状态，看是否有失败的复制任务。
  • 查看Publisher实例的error.log，搜索是否有和复制相关的报错（比如“permission denied”或者“path not found”）。

3. 文件夹或父节点被标记为「不复制」 #

如果目标文件夹（或者它的父节点）的属性cq:replicate被设为false，那么删除操作的复制请求会被发布代理直接忽略。

• 排查点：在Author的CRXDE Lite里找到目标文件夹，查看它的属性面板，确认cq:replicate不是false；同时检查父节点的继承设置，避免子节点继承了「不复制」的属性。

4. 工作流会话权限不足 #

工作流运行时使用的系统用户（默认是workflow-process-service）可能没有足够的权限触发复制操作，或者没有删除目标文件夹的权限。

• 排查点：
  • 检查工作流关联的系统用户是否拥有replication-replicator权限（在用户管理的权限配置里找）。
  • 查看工作流的日志（/var/workflow/instances下对应实例的日志），看是否有权限相关的报错信息。

5. 删除和创建的顺序导致复制冲突 #

如果你的代码里删除文件夹后立刻创建了同名文件夹，可能出现复制顺序混乱的问题：比如Publisher先收到创建请求，之后收到删除请求，但此时文件夹已经存在，删除请求可能被忽略；或者反过来，删除请求还没同步完成，创建请求就发过去了，导致Publisher上的文件夹没被删掉。

• 修复建议：调整代码逻辑，确保删除操作的复制请求完全完成后，再执行创建文件夹的操作。可以通过监听复制完成的事件，或者使用ReplicationResult来判断复制是否成功，再进行下一步。

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