AEM 6.x：如何临时/程序化禁用链接检查器（返回含链接JSON）

看起来你遇到的核心问题是AEM的Link Checker Transformer会对Servlet输出的JSON内容中的HTML链接进行检查和替换，即使尝试了程序化设置和配置修改也没生效。下面是几个可行的解决方案：

1. 通过响应头直接跳过Link Checker处理 #

在你的Servlet中添加响应头CQ-LinkChecker: skip，这个头会明确告诉Link Checker Transformer跳过对当前响应内容的处理：

protected void doGet(SlingHttpServletRequest request, SlingHttpServletResponse response) throws ServletException, IOException {
    // 添加这行代码，放在设置响应内容类型前后都可以
    response.setHeader("CQ-LinkChecker", "skip");
    
    response.setCharacterEncoding("UTF-8");
    response.setContentType("application/json;charset=UTF-8");
    
    // 获取APIX的JSON响应
    String jsonResponse = getApiXResponse();
    response.getWriter().write(jsonResponse);
}

这个方法无需修改全局配置，只针对当前Servlet的响应生效，完全符合你想要的临时/程序化禁用需求。

2. 在请求中设置属性禁用Link Checker #

另一种程序化方式是在请求中设置LinkCheckerSettings.DISABLE_LINKCHECKER属性，强制禁用整个请求链路中的链接检查：

import org.apache.sling.settings.LinkCheckerSettings;

protected void doGet(SlingHttpServletRequest request, SlingHttpServletResponse response) throws ServletException, IOException {
    // 在处理响应前设置这个属性
    request.setAttribute(LinkCheckerSettings.DISABLE_LINKCHECKER, Boolean.TRUE);
    
    response.setCharacterEncoding("UTF-8");
    response.setContentType("application/json;charset=UTF-8");
    
    String jsonResponse = getApiXResponse();
    response.getWriter().write(jsonResponse);
}

这个属性会让Link Checker组件忽略当前请求的所有链接检查操作，包括对响应内容中链接的解析处理。

3. 修正Link Checker Transformer的全局配置（可选） #

如果之前修改Day CQ Link Checker Transformer配置无效，可能是配置项没设置正确：

• 打开AEM的Config Manager（/system/console/configMgr），找到Day CQ Link Checker Transformer
• 检查Content Types字段，确保application/json不在列表中。如果存在，移除它并保存配置
• 同时确认Skip Links With Attribute字段包含x-cq-linkchecker="skip"，这样即使有HTML链接，带有该属性的也会被跳过

注意：修改全局配置会影响整个AEM实例，如果你只需要针对特定Servlet生效，优先选择前两种程序化方案。

为什么之前的方法无效？ #

你之前尝试的linkCheckerSettings.setIgnoreExternals(true)之所以没生效，是因为这个设置只针对请求过程中资源内部链接的检查，而Link Checker Transformer是在Servlet执行完成后，对响应输出的内容进行后处理，此时Servlet中的设置已经无法影响到Transformer的操作。另外，JSON中的x-cq-linkchecker="skip"属性没生效，可能是因为Transformer在解析JSON中的HTML片段时，没有正确识别该属性（Transformer通常更关注原生HTML响应中的属性）。

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