Android自定义Lint规则发布到远程仓库后仅部分生效

核心现象 #

• 本地通过implementation project(path: ':app:myLib')引入库时，2条自定义Lint规则均正常生效
• 将库发布为AAR到GitHub Packages后，远程依赖引入仅1条规则生效，另一条失效
• 已确认：代码逻辑无问题（本地验证通过）、AAR包已正确下载关联（一条规则生效）、本地与发布的.class文件完全一致

可能的排查方向 #

1. 检查Lint规则的注册与范围配置 #

• 确认失效规则的IssueRegistry注册逻辑：是否存在条件性注册（比如仅在debug编译模式、本地环境下才注册规则）
• 对比两条规则的Scope设置：失效规则的Scope是否限定了仅扫描本地模块，未覆盖远程依赖库的代码范围
• 验证失效规则的Issue属性：是否错误设置了仅本地生效的标识（比如implementation字段的特殊配置）

2. 验证发布流程中Lint规则的打包完整性 #

• 检查库模块的lintPublish配置：确认发布脚本是否完整包含了Lint规则模块的所有资源，而非仅编译生成的.class文件
• 解压发布到GitHub Packages的AAR包，查看是否存在META-INF/services/com.android.tools.lint.client.api.IssueRegistry文件，且文件中是否正确声明了失效规则对应的Registry类
• 对比本地构建AAR与远程AAR的META-INF目录：检查Lint相关配置文件是否完全一致，是否存在规则过滤、优先级配置的差异

3. 排查远程依赖下的Lint加载逻辑 #

• 检查项目中其他远程依赖：是否存在与失效规则ID重复的Lint规则，导致被覆盖
• 确认本地与远程依赖场景的AGP版本：部分AGP版本对Lint规则的加载逻辑有差异，确保两端使用的AGP版本一致
• 查看Lint执行日志：运行./gradlew lintDebug命令，搜索失效规则的相关日志，排查是否存在类加载失败、初始化异常等提示

4. 清理缓存并验证发布产物 #

• 清理本地Gradle缓存（删除~/.gradle/caches目录下对应依赖的缓存文件），重新拉取远程AAR后验证规则是否生效
• 确认发布到GitHub Packages的AAR为最新构建产物：检查版本号、构建时间，避免发布了旧版本缓存的包

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