AEM 6.5.8 配置压缩规则后自定义Client Library的JS未被正常压缩

核心成因 #

• Google Closure Compiler（GCC）编译失败回退：AEM Client Library的处理逻辑中，若压缩过程中GCC抛出语法/规则校验错误，会默认直接输出原始未压缩代码，不会抛出可见异常。你配置的compilationLevel=advanced是GCC要求最严格的编译模式，只要代码存在不符合规则的写法就会触发回退，这是该问题最常见的诱因。
• 配置参数冲突/不兼容：当前配置的GCC参数和AEM 6.5.8内置的GCC版本不匹配，或者自定义Client Library的.content.xml中存在minify=false等参数，覆盖了全局的minify开启配置。
• 代码存在特殊语法：JS文件中包含GCC无法识别的语法扩展（如未编译的TS、JSX、ES2020+语法）、特殊注释标记，也会导致压缩流程被跳过。

解决方案 #

第一步：排查GCC编译错误日志 #

进入AEM系统控制台/system/console/slinglog，新增日志配置：

• 日志级别设置为DEBUG
• 关联日志包：com.adobe.granite.ui.clientlibs.impl、com.google.javascript.jscomp
  保存后重新请求该Client Library的.min.js资源，查看对应日志文件中的GCC报错信息，可直接定位到具体的代码语法/规则问题。

第二步：验证配置有效性 #

先将jsProcessor临时替换为最简配置，确认压缩功能本身是否正常：
jsProcessor=[min:gcc;obfuscate=true;languageIn=ECMASCRIPT_2019;languageOut=ECMASCRIPT3;compilationLevel=simple]
若切换为simple模式后压缩正常，说明问题出在advanced模式的代码适配要求上，需要做如下修改：

• 所有全局变量、外部依赖变量（如AEM自带的Granite、jQuery）需通过/* global 变量名 */的头部注释提前声明
• 移除代码中无法被静态解析的动态语法（如window[动态变量名] = xxx）、未使用变量、未闭合逻辑块等问题

注意：AEM 6.5.8内置的GCC版本最高仅支持ES2019规范，若代码中使用了可选链?.、空值合并??等ES2020+语法，需先通过Babel编译到ES2019后再放入Client Library。

第三步：校验Client Library配置 #

检查自定义Client Library文件夹下的.content.xml：

• 确认未配置minify=false覆盖全局设置
• 确认jsProcessor参数的分隔符均为英文分号，无拼写错误、中文符号
• 确认未配置disableProcessors参数排除JS压缩处理

第四步：可选的降级方案 #

若代码无法适配GCC的advanced模式要求，可切换为容错性更高的YUI压缩工具，修改jsProcessor参数为：
jsProcessor=[min:yui]

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