AEM 6.0升级至6.3时遇linkrewriter类型Transformer组件获取失败错误

我帮你梳理下这个在AEM版本升级中很常见的问题，结合实际排查经验，给你几个具体的解决方向：

一、检查Sling Rewriter配置节点的结构与位置 #

AEM 6.3对Sling Rewriter的配置规则做了不少调整，你现在把配置放在/apps/<application>/config/rewriter，得先确认这几点：

• 确保rewriter的根配置节点是sling:Folder类型，下面每个transformer的配置节点是nt:unstructured，并且必须包含核心属性：
  • componentType：严格设置为linkrewriter（6.3对属性名和值的大小写敏感度更高，别写错）
  • type：填写你的Transformer实现类的完整限定名，比如com.yourcompany.rewriter.CustomLinkRewriter
  • 另外，6.3里的rewriter配置需要关联到具体的pipeline，记得给配置节点加上pipeline.type属性，或者确保你的配置被正确包含在对应pipeline的配置列表里。

二、验证Transformer组件的API适配与OSGi注册 #

从AEM 6.0到6.3，Sling Rewriter的Transformer接口有细节更新，得检查你的自定义实现：

• 确认你的Transformer类完整实现了org.apache.sling.rewriter.Transformer的所有方法，特别是6.3新增的方法（比如init方法的参数是否匹配新的API签名）。
• 检查组件的OSGi注册注解是否正确，比如用@Component注解时，要加上对应的属性：

  @Component(
      property = {
          "service.description=Custom Link Rewriter",
          "service.vendor=Your Company",
          "pipeline.type=linkrewriter"
      }
  )
  

  这里的pipeline.type要和配置里的componentType对应上。
• 确保你的bundle依赖的sling-rewriter-api版本适配AEM 6.3（6.3对应的版本大概是1.6.x，而6.0用的是更早的版本），避免依赖冲突导致组件无法加载。

三、检查OSGi组件状态 #

• 登录AEM的OSGi控制台（/system/console/components），搜索你的linkrewriter组件，看看它是不是处于Active状态。如果是Disabled或者Unsatisfied，点进去看详细错误信息，大概率是缺少依赖、配置参数不对或者类加载问题。
• 同时也检查下Sling Rewriter相关的核心服务，比如org.apache.sling.rewriter.TransformerFactory，确保它们都正常启动了。

四、迁移旧配置到6.3的规范结构 #

如果你的配置是从6.0直接拷贝过来的，可能不符合6.3的配置规范，推荐调整成工厂配置的方式：

• 把rewriter配置放在/apps/<application>/config/org.apache.sling.rewriter.impl.RewriterConfigurationFactory路径下，每个pipeline作为一个子节点，结构示例如下：

  /apps/yourapp/config/org.apache.sling.rewriter.impl.RewriterConfigurationFactory
    - your-custom-pipeline (nt:unstructured)
      - pipeline.type = "your-pipeline-id"
      - transformers = [ "linkrewriter", "other-transformer" ]
      - linkrewriter (nt:unstructured)
        - componentType = "linkrewriter"
        - type = "com.yourcompany.rewriter.CustomLinkRewriter"
        - // 你的自定义配置属性，比如rewriteRules等
  

五、通过日志定位具体问题 #

如果上面的步骤还是没解决，去看AEM的错误日志（crx-quickstart/logs/error.log），搜索linkrewriter或者Transformer相关的关键词，日志里的堆栈跟踪会告诉你具体的问题——比如某个类找不到、依赖缺失、配置属性格式错误等，这些细节是排查的关键。

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