本地AEM环境下为锚点a标签添加href后标签被剥离仅留文本的问题
AEM 带href属性的a标签被完全剥离的排查方案
现象匹配
你遇到的无href的a标签正常渲染、带href的a标签被整体剥离仅留文本,是AEM场景下链接校验逻辑触发的标准表现:不带href的锚点完全不触发链接校验流程,因此可以正常保留标签结构和样式。
核心排查路径
- 优先校验
Day CQ Link Checker Service配置- 确认测试账号对href指向的
/content/mypage.html路径有读取权限,且对应资源在当前环境真实存在 - 进入AEM Web控制台配置页,找到
Day CQ Link Checker Service配置项:- 检查“排除标签”规则是否误将
<a>纳入过滤范围 - 检查路径匹配规则是否将你的测试路径标记为不可输出
- 临时开启
Check Disabled选项暂停链接校验,刷新页面验证锚点是否恢复正常渲染
- 检查“排除标签”规则是否误将
- 确认测试账号对href指向的
- 检查全链路HTML过滤逻辑
- 排查服务端渲染阶段的HTML清洗规则:
- 若使用jsoup做标签清洗,确认Safelist白名单同时允许
<a>标签、以及href、class等属性输出——缺失属性白名单时,带href的a标签会被整体判定为非法标签移除 - 若使用HTL编写模板,确认锚点渲染上下文没有误设为
text,否则标签结构会被整体转义为纯文本
- 若使用jsoup做标签清洗,确认Safelist白名单同时允许
- 若锚点是在富文本编辑器(RTE)中写入的,检查RTE的输出白名单,确认带
/content前缀的内部链接没有被拦截规则匹配
- 排查服务端渲染阶段的HTML清洗规则:
- 快速定位问题层的验证方法
- 查看服务端返回的原始页面源代码(快捷键
Ctrl+U,不要参考DevTools中动态修改后的DOM):如果源代码中已经不存在a标签,问题出在服务端过滤逻辑,和前端脚本无关 - 临时将a标签的href值替换为
#,刷新页面验证:如果替换后锚点正常保留样式,说明原href对应的资源路径被LinkChecker判定为无效,触发了标签剥离逻辑
- 查看服务端返回的原始页面源代码(快捷键
常见避坑
- 不要临时通过HTL的
context='unsafe'绕过过滤输出标签,该方式会完全跳过XSS防护,存在安全隐患 - 调整完LinkChecker配置后,记得清理对应路径的Sling缓存、页面缓存,否则配置不会即时生效
内容的提问来源于stack exchange,提问作者Gavin Wood
相关产品推荐
相关产品推荐

