Adobe Experience Manager云服务Dispatcher自定义Header配置不生效排查

配置路径说明 #

你当前在\dispatcher\src\conf.d\available_vhosts下直接添加Header配置的方式不符合AEM云服务的规范，这是导致配置不生效的核心原因之一。正确的配置位置分两种场景：

• 全局Header：在dispatcher/src/conf.d/headers目录下创建独立的配置文件（例如custom-security-headers.conf），把Header set X-XSS-Protection "1; mode=block"这类配置放在里面，然后在你的farm配置文件（dispatcher/src/conf.d/available_farms/<your-farm-name>.conf）中添加Include conf.d/headers/*.conf，确保该配置被加载。
• 虚拟主机专属Header：如果需要针对特定域名设置Header，要在available_vhosts下对应域名的vhost配置文件的<VirtualHost>代码块内添加Header指令，同时必须将该vhost文件软链接到dispatcher/src/conf.d/enabled_vhosts目录——云服务只会加载enabled_vhosts下的虚拟主机配置。

云服务专属注意事项 #

AEM云服务的Dispatcher有默认配置约束，需注意：

• 部分安全Header（包括X-XSS-Protection）可能已被云服务的默认安全策略预设，若你的自定义配置未生效，可尝试改用Header always set提升优先级，例如：

  Header always set X-XSS-Protection "1; mode=block"
  

• 确保配置中使用的Apache指令是云服务支持的，避免使用mod_headers之外的扩展指令。
• 部署后需等待5-10分钟，让云服务完成Dispatcher配置的同步和生效，不要立即测试。

权限问题说明 #

只要你拥有项目代码库的提交权限，就能修改Dispatcher配置，AEM云服务不会默认限制Header配置的权限。配置不生效几乎都是路径、语法或默认配置覆盖的问题，和权限无关。

验证步骤 #

1. 检查farm或vhost配置中是否正确引入了自定义Header的配置文件。
2. 查看云服务部署日志，确认Dispatcher配置部署无语法错误。
3. 用curl -I https://your-dev-domain.com命令获取响应Header，对比本地测试结果。

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