本地与GitLab CI（MacOS环境）执行Detekt结果不一致，CI会扫描build目录生成文件

看起来你遇到的这个本地和CI环境Detekt行为不一致的问题确实挺挠头的——我之前也碰到过类似的Gradle任务在不同环境下路径匹配差异的坑，结合你的配置和环境信息，我整理几个可能的原因和对应的解决办法：

1. 路径匹配的环境差异（最可能的根因） #

你当前用的是字符串形式的排除规则**/build/**，但这个相对路径的解析逻辑在本地和CI的MacOS环境下可能存在差异：

• 本地环境下，Gradle会基于模块目录正确解析相对路径，但在CI的MacOS runner上，因为你设置了basePath = rootDir.toString()，相对路径的匹配基准变成了项目根目录，导致**/build/**没精准命中模块下的build目录。
• 另外，MacOS默认是大小写不敏感的文件系统，虽然你写的是小写build，但如果CI环境下的缓存残留了大写BUILD目录的痕迹，字符串匹配可能会失效。

解决办法（亲测有效）：
放弃字符串相对路径，改用Gradle提供的绝对路径变量来排除，确保在任何环境下都能精准命中：

tasks.withType<Detekt> {
    // 用Gradle内置的buildDirectory变量获取绝对路径，避免相对路径解析差异
    exclude(project.layout.buildDirectory.asFile.get().absolutePath)
    exclude(resourceFiles)
    // 其他原有配置...
}

同时在你的detekt.yml全局配置里添加全局排除规则（优先级比任务级配置更高）：

excludes:
  - "**/build/**"
  - "**/resources/**"

2. GitLab Report插件的隐性影响 #

你引入的detektGitlabReport插件可能在CI环境下悄悄调整了Detekt的扫描范围——部分报告插件为了确保能收集到所有潜在问题，会自动修改source或exclude配置，这是很多人容易忽略的点。

解决办法：
在CI的script里添加调试日志，对比本地和CI的扫描范围差异：

# 在GitLab CI的script里加入这行，查看实际排除的路径
./gradlew detekt --info | grep -E "Excluding|Source files"

如果确实是插件的问题，可以在CI环境下强制覆盖source集合，确保只扫描业务代码：

tasks.withType<Detekt> {
    // 强制只扫描src/main下的Kotlin/Java代码，覆盖任何自动添加的source
    source.setFrom(
        project.layout.projectDirectory.dir("src/main/kotlin"),
        project.layout.projectDirectory.dir("src/main/java")
    )
    // 其他原有配置...
}

3. CI环境的缓存残留影响 #

CI环境下的Gradle缓存可能残留了之前构建的build目录文件，导致Detekt扫描到了不属于当前构建的生成文件。

解决办法：
在CI的script里先执行clean任务，确保build目录是干净的：

./gradlew clean detekt

或者把detekt任务绑定到clean任务，强制先清理再扫描：

tasks.withType<Detekt> {
    dependsOn(tasks.clean)
    // 其他原有配置...
}

4. 旧版本Detekt的已知bug #

你用的是Detekt 1.23.0，这个版本已经有一段时间了，路径匹配模块存在一些跨环境一致性的已知问题，升级到最新的稳定版（比如1.24.0+）可能会直接解决这个问题。

内容来源于stack exchange