Réparer la compilation Kotlin dans Android : résoudre l'erreur compileDebugKotlin

Introduction : Votre projet Kotlin a soudainement planté ? Pas de panique !

Vous écrivez du code en Kotlin, tout fonctionne, et soudain — boum ! — lors de la compilation, un message rouge apparaît : Error:Execution failed for task ':app:compileDebugKotlin'. > Compilation error. See log for more details. Si vous avez déjà touché au développement Android, vous connaissez cette sensation quand Gradle décide soudainement que ce n'est pas son jour. Cette erreur est l'une des plus fréquentes sur Stack Overflow, et aujourd'hui nous allons la décortiquer de A à Z.

Dans ce tutoriel, nous ne nous contenterons pas de copier une réponse trouvée en ligne. Nous allons comprendre pourquoi Kotlin refuse parfois de compiler, et apprendre à réparer cela rapidement et sans douleur. C'est parti !

Que signifie réellement cette erreur ?

Allons droit au but. Le message Execution failed for task ':app:compileDebugKotlin'. > Compilation error nous indique que le compilateur Kotlin a trouvé quelque chose dans votre code qui ne lui plaît pas. Le plus sournois, c'est qu'Android Studio affiche souvent ce message générique, mais cache la cause précise dans les logs. L'expression "See log for more details" n'est pas une formule vide. C'est dans les logs (Build Output ou Run) qu'il faut chercher le vrai problème.

Mais ne vous précipitez pas à fouiller les logs. Il existe plusieurs scénarios typiques qui provoquent cette erreur dans 90 % des cas.

Les causes principales (liste d'auto-diagnostic)

\n
• Incompatibilité entre les versions de Kotlin et du plugin Gradle. Un classique. Vous avez mis à jour Kotlin, mais oublié de mettre à jour le plugin dans build.gradle — et l'erreur apparaît.
\n
• Conflit d'annotations. Kotlin est très strict avec les annotations (par exemple, @Nullable vs @NotNull). Une mauvaise utilisation peut casser la compilation.
\n
• Mauvaise cible JVM. Si vous utilisez des fonctionnalités d'une nouvelle version de Kotlin, mais que la cible JVM est ancienne, le compilateur râlera.
\n
• Problèmes de cache. Oui, Gradle et Android Studio "oublient" parfois que vous avez corrigé l'erreur et continuent d'afficher l'ancienne.
\n
• Erreurs de syntaxe en Kotlin. Une parenthèse manquante, un type incorrect — tout cela peut déclencher cette erreur, même si le message semble être un problème général de build.
\n

Étape 1 : Lire les logs correctement (la compétence clé du développeur)

Avant de modifier quoi que ce soit, ouvrez l'onglet Build dans Android Studio (généralement en bas). S'il est vide, cliquez sur View → Tool Windows → Build. Cherchez les lignes en rouge. L'information la plus importante commence souvent par e: ou error:.

Exemple tiré d'un vrai log :

e: /Users/user/Project/app/src/main/java/com/example/MainActivity.kt: (12, 5): Null can not be a value of a non-null type String

Vous voyez ? Le compilateur dit honnêtement : "À la ligne 12, caractère 5, vous essayez d'assigner null à une variable qui ne peut pas être null". Tout simple. Maintenant, vous savez où chercher.

Étape 2 : Les trois solutions les plus courantes (avec code)

Examinons chaque cas avec des exemples. Ouvrez votre fichier build.gradle (Module: app).

Solution n°1 : Mettre à jour Kotlin et le plugin Gradle

C'est la première chose à vérifier. Assurez-vous que la version de Kotlin dans build.gradle (au niveau du projet) correspond à la version du plugin.

// build.gradle (Project level)\nbuildscript {\n    ext.kotlin_version = '1.9.22' // Vérifiez la version actuelle sur kotlinlang.org\n    repositories {\n        google()\n        mavenCentral()\n    }\n    dependencies {\n        classpath 'com.android.tools.build:gradle:8.2.2' // La version Gradle doit être compatible avec Kotlin\n        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"\n    }\n}

Si vous utilisez Kotlin 1.8+, assurez-vous que le plugin Gradle suit également. Après la mise à jour, cliquez sur "Sync Now".