KSP 2.3.13でDaggerやHiltのビルドがときどき失敗する問題|2.3.14へ上げる手順と、30回ずつビルドして比べた結果
KSP 2.3.13には、生成コードがときどき欠ける回帰がある
Googleが開発しているKSP(Kotlin Symbol Processing)の2.3.13が日本時間2026年10月31日に公開され、そのあと、並行して動くKSPの実行で生成コードが欠ける回帰が見つかりました(issue #3286)。KSPは、Kotlinのコードを読んで、決まった形のコードを自動で生成する仕組みです。Android開発でよく使うHilt、Dagger、Roomなどが、KSPの上で動くプロセッサーを用意しています。
2.3.13のリリースノートには、あとから「Defect in release」として、この回帰でKSPの並行実行に問題が起きうるという注記が加わりました(2.3.13のリリースノート)。修正版の2.3.14は、日本時間11月14日に公開されています(2.3.14のリリースノート)。issueには、HiltのアプリでビルドがときどきMissingBindingのエラーで止まるという報告も寄せられています。
この記事では、Daggerを使う24モジュールのKotlinのプロジェクトを作り、KSPの2.3.12、2.3.13、2.3.14で同じビルドを繰り返して比べました。失敗がどう見えるか、なぜ起きるか、2.3.14へ上げる手順と版の確かめ方を順に説明します。
要点
KSP 2.3.13を使っているなら2.3.14へ。手元の比較では、2.3.13だけがときどき生成コードを欠かした
Daggerを使う24モジュールのプロジェクトで、同じビルドを繰り返した結果です。
KSP 2.3.13
30回中6回、どれか1〜2モジュールのDaggerの生成ファイルが0個になり、ビルドが失敗した
欠けたモジュールは、m21・m22・m24の3つにまたがりました。
KSP 2.3.14
同じ手順の30回は、すべて成功した
2.3.12も20回すべて成功しました。
失敗の見え方
手元では、KSPのタスクは成功し、そのあとのコンパイルが「Unresolved reference」で失敗した
issueには、KSPの処理の中でDaggerがエラーを出す例も挙がっています。
対処
KSPの版を2.3.14に書き換える
2.3.13でorg.gradle.parallel=falseにしても、30回中1回は失敗しました。
KSPの3つの版で、24モジュールのDaggerのプロジェクトを20〜30回ずつビルドした結果
検証用のプロジェクトは、Kotlin/JVMのモジュールを24個並べたものです。各モジュールでDagger 2.60.1のプロセッサーをKSPで動かし、@Module、@Inject、@Componentから、モジュールごとに5個のファイルを生成させます。生成されたDaggerM01Componentなどはモジュールのコードから呼んでいるので、生成コードが欠けるとコンパイルが失敗します。
Gradle 9.8.2でorg.gradle.parallel=trueにして、gradle compileKotlin --rerun-tasksを繰り返しました。KSPの版だけを変えた結果が次のとおりです。
ビルドが失敗した回数(24モジュール、Gradle 9.8.2)
KSP 2.3.12:20回中0回
KSP 2.3.13:30回中6回
KSP 2.3.13(org.gradle.parallel=false):30回中1回
KSP 2.3.14:30回中0回
gradle compileKotlin --rerun-tasksを繰り返した結果で、注記のないものはorg.gradle.parallel=true。macOS 27.2.1(Apple Silicon)、Kotlin Gradleプラグイン 2.4.21、Dagger 2.60.1、JDK 21で、2026年11月18日に確認。2.3.13で失敗した6回は、どれもモジュールが1〜2個だけ、Daggerの生成ファイルを1つも持たない状態でした。欠けたのはm21、m22、m24のいずれかで、m22は6回のうち4回(うち1回はm21と一緒に)欠けました。同じ設定でもう一度ビルドすると、多くの回は成功します。CIで「ときどき落ちて、再実行すると通る」ビルドになるのは、この性質のためです。
並列ビルドを切ったorg.gradle.parallel=falseでも、2.3.13は30回中1回失敗しました。並列の設定を変えるだけでは、この回帰を避けきれません。
手元では、KSPのタスクは成功し、そのあとのコンパイルで失敗した
手元のプロジェクトでは、生成コードが欠けた回も、KSPのタスク(:m22:kspKotlinなど)はエラーも警告も出さずに終わりました。失敗として表に出るのは、生成されるはずだったクラスを参照するコンパイルの段階です。エラーは次のとおりです。
> Task :m22:kspKotlin
> Task :m22:compileKotlin FAILED
e: file:///…/m22/src/main/kotlin/m22/Main.kt:3:30 Unresolved reference 'DaggerM22Component'.
生成コードを参照するコード(Main.kt)を置く前に、gradle kspKotlinだけを2.3.13で実行したときは、ビルドが成功のまま、m22とm24の生成ファイルが0個でした。生成コードを参照するコードがなければ、欠けても失敗として表に出ません。
issue #3286の本文には、KSPの処理の中でDaggerが'javax.inject.Named' could not be resolvedのようなエラーを出す例も挙がっています。Hiltを使うアプリでは、別の形で失敗したという利用者の報告があります。ライブラリのモジュールのkspDebugKotlinはエラーなしで終わり、アプリのhiltJavaCompileDebugがときどき[Dagger/MissingBinding]で失敗するというものです。報告では、2.3.12のままのブランチは問題なくビルドでき、KSPの版を上げる変更だけで失敗が出ていました。
この回帰を疑う手がかり
- KSPを2.3.13に上げてから、ビルドがときどき失敗するようになった
- 生成コードを参照する段階(Unresolved reference、Hiltの
[Dagger/MissingBinding]など)で失敗する。KSPのタスクでcould not be resolvedのようなエラーが出ることもある - 失敗するモジュールが毎回同じとは限らず、再実行すると通ることがある
- モジュールが多く、Gradleが複数のKSPのタスクを同時に動かす
KSP 2.3.13は、共有のキャッシュが消されるとライブラリのファイルを見失う
issue #3286の分析によると、原因は、KSPが読み込んだライブラリのJARを管理するキャッシュにあります。KSP2はGradleのデーモンの中で動くため、モジュールが多いと、複数のKSPの実行が同時に動くことがあります。1つのKSPの実行が終わるたびにこの共有のキャッシュを消す処理は、2.3.12にもありました。2.3.13では、ファイルがライブラリのJARに含まれるかの判定が、パスの比較から、キャッシュが作るオブジェクトの比較に変わりました。そのため、ほかの実行がキャッシュを消すと、まだ動いている実行が、同じJARのファイルを、そのJARに含まれないと判定するようになりました。
1
モジュールAのKSPが終わり、共有のJARのキャッシュを消す(2.3.12でも同じ)
2
同時に動いていたモジュールBのKSPが、キャッシュの作り直しのあとに見つけたライブラリのファイルを、そのJARに含まれないと判定し、javax.inject.Namedのような注釈を解決できなくなる(2.3.13で起きる)
3
モジュールBのプロセッサーが、生成すべきコードを作らないまま終わる
2.3.14では、動いているKSPの実行がほかにないときだけ、このキャッシュを消すように変わりました(#3294、#3300)。同時に動くKSPの実行が多いほど、キャッシュが消される機会も増えます。issueに寄せられた利用者の報告でも、同じCIの中で、KSPのタスクを多く同時に動かすtestDebugのジョブだけが失敗し、assembleDebugのジョブは通っていました。
2.3.13の回帰への対処は、KSPを2.3.14へ上げること
2.3.13を使っていないプロジェクトは、この回帰の対象外です。2.3.13を使っている場合は、KSPのGradleプラグインの版を2.3.14へ書き換えます。版を書いている場所は、プロジェクトによって次のどちらかです。
# gradle/libs.versions.toml を使っている場合
[versions]
ksp = "2.3.14"
[plugins]
ksp = { id = "com.google.devtools.ksp", version.ref = "ksp" }
// build.gradle.kts の plugins に直接書いている場合
plugins {
id("com.google.devtools.ksp") version "2.3.14" apply false
}
書き換えたら、Gradleが実際に使っているKSPの版を確かめます。手元の2.3.14のプロジェクトでは、次のコマンドの出力にsymbol-processing-gradle-plugin:2.3.14が出ました。
./gradlew buildEnvironment | grep symbol-processing
KSPのプラグインをモジュールのbuild.gradle.ktsにだけ書いている構成では、ルートのbuildEnvironmentにはKSPの行が出ません。その場合は、KSPを使うモジュールを指定して、./gradlew :app:buildEnvironment | grep symbol-processingのように実行します。書き換える前に同じコマンドを実行すれば、いま2.3.13を使っているかも確かめられます。
すぐに2.3.14へ上げられない事情があるなら、一時的に2.3.12へ戻す方法もあります。手元の比較では、2.3.12も20回すべて成功しました。2.3.12へ戻すと、2.3.13で入ったほかの修正(JARの中身がときどき見えなくなる別の不具合への対策など)や新しいAPIも使えなくなるので、上げられるようになったら2.3.14へ上げます。
KSP 2.3.14のそのほかの変更
2.3.14には、この回帰の修正のほかに、次の変更が入っています(2.3.14のリリースノート)。プロセッサーを自分で書いている人に関係するものが中心です。
context parametersを読める
関数やプロパティのKotlinのcontext parametersを、KSContextParameterとして読めるようになりました。
変更がない増分ビルドで処理を飛ばす
増分ビルドで変わったファイルがないとき、解析の準備とプロセッサーの実行を飛ばします。
注釈の引数の扱いの修正
引数なしで付けた注釈でvarargの引数が抜けていた問題と、配列の既定値の扱いがプラットフォームで違っていた問題が直りました。
型パラメーターの上限の修正
型パラメーターの上限に型エイリアスを書いたとき、KSTypeParameter.boundsが展開後の型を返していた問題が直りました。
2.3.13を使っていて、HiltやRoomなどのプロセッサーを使っているだけのアプリでは、まず回帰の修正のために2.3.14へ上げ、CIでビルドが安定したかを確かめます。
参考資料
- KSP 2.3.14のリリースノート
- KSP 2.3.13のリリースノート(Defect in releaseの注記)
- issue #3286: KSP 2.3.13 regression: library symbols disappear during concurrent in-process executions
- 修正のプルリクエスト: #3294、#3300
検証環境
- macOS 27.2.1(Apple Silicon)、JDK 21.0.8(Android Studio同梱のJetBrains Runtime)
- Gradle 9.8.2、Kotlin Gradleプラグイン 2.4.21、Dagger 2.60.1
- KSP 2.3.12・2.3.13・2.3.14
- 検証日: 2026年11月18日
この記事は、AIが調査と下書きを担当し、上記の環境で実際に動かして結果を確かめ、下書きとは別の担当が公開前に本文と出典を確認しています。制作と訂正の方針は編集・訂正方針で公開しています。












