第二章 版本号声明与依赖坐标变更：识别新版Compiler的Maven坐标变更

2.1 现象识别

升级 Compose Compiler 时，最直接的编译失败信号来自 Gradle 依赖解析阶段。常见现象包括：

• 构建报错：类似 Could not resolve org.jetbrains.compose.compiler:compiler:1.5.0 或 Unable to find artifact。
• 版本不存在：Log 中提示 not found 或 404，即使你确信版本号正确。
• 仓库源不可达：报错信息中包含 repository、mavenCentral、google() 等关键词，并伴有超时或连接拒绝。
• Gradle 同步失败：IDE 弹出红色提示，build.gradle 文件中相关坐标行被标红。

2.2 数据采集

使用以下表格系统收集现场信息，帮助后续定位：

org.jetbrains.compose:compose-compiler:1.5.0

repositories {
    mavenCentral()
    google()
}

2.3 原因定位——基于故障树的根因分析

故障树将依赖解析失败细化为两类根本原因：坐标错误 与 仓库问题。下图展示完整排查路径：

2.4 修复动作

根据故障树定位到的具体原因，执行对应修复操作：

• 坐标错误：
  • group/artifact 变更：查阅 Compose Compiler 官方 版本说明，将坐标更新为最新格式。例如旧版 org.jetbrains.compose:compose-compiler:1.4.0 在 1.5.0 后改为 org.jetbrains.compose.compiler:compiler:1.5.0（注意 group 和 artifact 都拆分了）。
  • version 不存在：确认版本号是否在 Maven Central 上真正发布，或改用 BOM 版本对齐：

  // BOM 方式（推荐）
  dependencies {
      implementation platform("org.jetbrains.compose:compose-bom:2024.01.00")
      implementation "org.jetbrains.compose.compiler:compiler"
  }

• 仓库问题：
  • 仓库未配置：在 settings.gradle 中增加 mavenCentral()；若使用 Kotlin DSL，写法同上。
  • URL 错误：检查仓库地址是否包含拼写错误（如 mavenCentral 误写为 mavencentral），或是否因国内网络需要配置镜像。
  • 凭证过期：私有仓库需更新 gradle.properties 中的用户名密码或 。

2.5 复测及预防

修复后执行以下三步验证：

1. 清理并刷新：运行 ./gradlew clean --refresh-dependencies，避免缓存干扰。
2. 编译检查：运行 ./gradlew assembleDebug，确保无依赖解析错误。
3. 版本锁定：使用 Gradle 的 dependencyLocking 插件或 libs.versions.toml 集中管理 Compose Compiler 坐标，防止后续因疏忽引入错误：

// gradle/libs.versions.toml
[versions]
compose-compiler = "1.5.0"

[libraries]
compose-compiler = { group = "org.jetbrains.compose.compiler", name = "compiler", version.ref = "compose-compiler" }

[plugins]
compose-compiler = { id = "org.jetbrains.compose", version.ref = "compose-compiler" }

2.6 预防性排查表

遵循上述流程，可将版本号声明与依赖坐标相关问题在 10 分钟内定位并修复，有效减少升级阻塞时间。