Kotlin 兼容性变化：编译器、JVM 目标与多平台代码

Kotlin 的版本升级既可能影响语言诊断，也可能影响编译后产物与多平台工程结构。项目若同时使用 JVM、JavaScript 或原生目标，风险点会比单平台工程更多。应把 Kotlin 编译器版本、构建插件版本、JVM 目标和协程等关键依赖分别记录，避免一次升级中混入过多变量。

先处理新诊断揭示的问题

候选编译器可能把原先的提示提升为警告或错误。面对这类变化，先按空安全、泛型、可见性、重载解析和弃用调用分类。不要立刻全局压制诊断；很多新提示反映了真实的空引用风险或调用歧义。对于每项修订，应通过单元测试确认行为保持不变，尤其是默认参数、扩展函数和委托属性附近的代码。

JVM 目标必须与 Java 生态对齐

在 JVM 项目中，Kotlin 字节码目标、Java 编译目标和运行时 JDK 应保持可解释的一致关系。若两个语言模块产出不同级别字节码，打包或运行时可能出现难以定位的问题。升级后检查构建输出和测试执行器实际使用的 JDK，并在部署镜像中再次查询运行时版本。调用 Java 库的边界应覆盖空值注解、集合可变性和异常传播等互操作细节。

协程与并发测试要覆盖取消

协程库及调度器版本变化可能影响测试时序、取消传播和异常呈现。建议为超时、父子任务取消、资源关闭和异常聚合建立稳定用例，不要依赖固定睡眠时间等待结果。测试中可使用受控调度器或明确同步点，使失败更容易复现。若业务使用流式处理，还应验证背压、重复收集和错误恢复路径。

多平台源集需逐目标编译

共享代码能编译不代表每个实际目标都满足依赖与 API 条件。候选升级应分别执行各目标的编译和关键测试，重点查看 expect 与 actual 声明、平台专用依赖和资源处理。对于浏览器或原生目标，还应在对应运行环境执行最小启动验证。不要把 JVM 的成功结果外推给其余目标。

构建插件与缓存是独立变量

Gradle 插件、增量编译缓存和代码生成器会显著影响迁移结果。升级时可先清理缓存完成一次完整构建，再比较增量构建是否正常。Kotlin 编译器、构建插件和依赖的支持范围可能改变，请以当期发布说明和使用组件的维护信息为准。

当诊断、字节码、协程和各平台目标均获得验证时，Kotlin 的兼容性变化才不会在发布后以隐蔽方式出现。