Android项目Lint基线异常咨询：条目不匹配及重复报错问题

疑问1：重新生成基线后仍出现“基线中问题未找到”的报错？ #

这种情况大概率是构建环境的缓存/同步问题或者Lint版本不一致导致的，具体原因可能有这些：

• Jenkins工作区未同步最新基线：虽然你在本地生成了新的lint-baseline.xml并推送到Gerrit，但Jenkins构建时可能因为工作区缓存（比如之前的旧文件没被覆盖）、拉取代码不彻底，导致实际读取的还是旧的基线文件。旧基线里的ApplySharedPref、ObsoleteLintCustomCheck这些问题在新代码里已经不存在，所以Lint会抛出“未找到”的提示。
• 本地与Jenkins的Lint版本不匹配：Lint是Android Gradle Plugin（AGP）的一部分，不同AGP版本对规则的识别、问题类型的命名可能有差异。比如你本地用的AGP版本已经移除了ObsoleteLintCustomCheck规则，但Jenkins上的旧版本还在识别这个规则，导致基线里的条目和实际扫描结果不匹配。
• 基线生成范围不完整：如果你本地生成基线时只针对单个变体（比如lintDebug），但Jenkins构建时扫描了多个变体（比如lintDebug+lintRelease），不同变体的基线规则不统一，也会出现这类不匹配的报错。

疑问2：同类型报错未被合并？ #

这是Lint日志输出的阶段化扫描特性导致的：

• 如果你项目包含多个模块（主模块+依赖库），或者Jenkins构建脚本执行了多个Lint任务（比如分变体、分模块扫描），Lint会针对每个扫描单元单独输出基线过滤统计。比如第一条是主模块的扫描结果，第二条是某个依赖库的扫描结果，两者的ApplySharedPref问题没有被合并输出，就会出现重复的日志。
• 另外，Lint在处理“基线未找到问题”和“基线过滤问题”时是分开统计的，前者是基线里的旧问题不存在了，后者是当前代码里的问题被基线过滤，这两类日志本身就不会合并。

具体解决步骤 #

1. 强制Jenkins同步最新基线：
   在Jenkins构建脚本开头添加清理工作区的步骤，确保拉取到最新代码：

   git clean -fdx
   git pull origin <你的目标分支>
   

2. 统一本地与Jenkins的AGP版本：
   检查项目根目录build.gradle里的AGP版本，比如：

   dependencies {
       classpath 'com.android.tools.build:gradle:7.4.2'
   }
   

   确保Jenkins构建环境使用的Gradle和AGP版本与本地完全一致，避免规则识别差异。

3. 重新生成全范围基线：
   本地执行全变体的Lint基线生成命令，覆盖所有模块：

   ./gradlew lint --baseline lint-baseline.xml
   

   推送新基线到Gerrit后，确认Jenkins构建时使用的是这份全范围基线。

4. 检查Jenkins的Lint执行命令：
   查看Jenkins构建日志里的Lint参数，确认是否指定了正确的基线路径，比如：

   ./gradlew lintDebug -Pandroid.lint.baseline=lint-baseline.xml
   

   避免多个Lint任务重复执行导致日志重复。

5. 手动在Jenkins工作区验证：
   登录Jenkins服务器，进入项目工作区手动执行Lint命令，观察输出是否和构建日志一致，以此排查是脚本问题还是环境问题。

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