AEM Publish实例页面重定向失效问题排查与解决求助

问题现象 #

测试环境的AEM Publish实例表现异常：配置了重定向属性的页面并未执行实际跳转，仅显示提示文本“此页面将重定向至（目标页面链接）”，行为与Author实例一致。

已完成排查 #

• 确认命令行启动参数设置的运行模式为publish
• 当页面URL携带查询参数?wcmmode=disabled时，重定向可正常触发（效果等同于Author实例的“以发布视图查看”）
• 登录用户与匿名用户访问该页面时，异常行为完全一致

行为对比 #

• 实际行为：访问页面 [host:publish_port]/content/we-retail.html，页面显示“此页面将重定向至English”
• 预期行为：页面返回302 Found状态码，自动跳转至[host:publish_port]/content/we-retail/us/en.html

根本原因分析 #

这类问题核心是Publish实例的WCM模式未自动禁用，导致页面渲染沿用了Author端逻辑——Author模式下为方便编辑，会显示重定向提示而非直接跳转，而Publish实例默认应自动禁用WCM模式，直接执行重定向。

可能的具体诱因：

1. OSGi配置异常：Adobe Granite WCM Mode Filter未正确识别Publish运行模式，未自动将默认WCM模式设为disabled
2. 自定义代码干扰：项目自定义的Servlet、过滤器或组件逻辑未区分publish/author模式，强制保留了Author端的提示渲染逻辑
3. 发布包污染：发布到Publish实例的内容包混入了Author端专属的模板、组件或配置，覆盖了生产端的重定向逻辑

修复方案 #

1. 检查并修正WCM Mode Filter配置 #

• 进入AEM控制台的OSGi配置管理页面（/system/console/configMgr），找到Adobe Granite WCM Mode Filter
• 确认Run Modes字段包含publish，且Default Mode设置为disabled
• 若配置错误，修正后保存并重启相关服务

2. 排查并修复自定义代码 #

• 检查项目中所有涉及重定向处理的Servlet、过滤器、Sling Model或组件代码，确认是否存在未区分运行模式的逻辑
• 确保Publish模式下直接返回302重定向，示例代码参考：

  SlingSettingsService settings = resourceResolver.adaptTo(SlingSettingsService.class);
  if (settings.getRunModes().contains("publish")) {
      response.sendRedirect(targetUrl);
      return;
  }
  // Author模式下保留提示逻辑
  

3. 清理并重新发布内容包 #

• 检查已发布到Publish实例的内容包，确认是否包含Author端专属配置或组件
• 重新打包并发布生产端专属的内容包，覆盖异常配置

4. 二次验证运行模式 #

• 通过AEM控制台（/system/console/status-slingsettings）再次确认实例运行模式为publish
• 检查启动参数，排除可能干扰运行模式的异常配置项

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