Smart cast dans Kotlin : pourquoi une variable a pu changer et comment y remédier en 2025

Formateur Python en ligne pour débutants

Apprenez Python facilement sans surcharge théorique. Résolvez des tâches pratiques avec vérification automatique et écrivez du code directement dans le navigateur.

Start Course

« Je viens pourtant de vérifier ! » — la douleur familière de tout développeur Kotlin

Vous codez en Kotlin, vous appréciez sa concision et sa sécurité, quand soudain — une ligne ondulée rouge. Le compilateur affiche : Smart cast to 'Type' is impossible, because 'variable' is a mutable property that could have been changed by this time. Familier ? Si vous avez déjà rencontré cette erreur, vous n'êtes pas seul. Cette question est l'une des plus populaires sur Stack Overflow, et pour cause : elle soulève un sujet fondamental — comment Kotlin nous protège de nous-mêmes.

Dans cet article, nous ne nous contenterons pas d'expliquer pourquoi l'erreur se produit, mais nous montrerons aussi comment la contourner élégamment en 2025. Vous découvrirez ce qu'est le smart cast (cast intelligent), pourquoi Kotlin ne fait pas confiance aux propriétés mutables, et quelles meilleures pratiques vous aideront à écrire un code propre et sûr sans « béquilles » inutiles. C'est parti !

\n\n

Qu'est-ce que le smart cast et pourquoi est-il « intelligent » ?

L'un des points forts de Kotlin est le smart cast (cast intelligent). C'est lorsque le compilateur comprend tout seul qu'après avoir vérifié le type d'une variable, on peut l'utiliser comme ce type, sans cast explicite. Par exemple :

fun printLength(obj: Any) {\n    if (obj is String) {\n        // Smart cast : obj est automatiquement devenu String\n        println(obj.length)\n    }\n}

Joli, non ? Le compilateur voit : « Tiens, nous avons vérifié que obj est un String, donc à l'intérieur du bloc if, c'est bien une chaîne, on peut appeler length ». C'est ça, le smart cast.

Mais il y a un hic : cette astuce ne fonctionne que si le compilateur peut garantir que la variable ne changera pas entre la vérification et l'utilisation. En revanche, si la variable est un var (variable), il n'y a aucune garantie. Et là, les ennuis commencent.

\n\n

La racine du mal : mutable property (propriété mutable)

Regardons un exemple typique qui provoque l'erreur :

class UserRepository {\n    var currentUser: User? = null\n\n    fun printUserName() {\n        if (currentUser != null) {\n            // Erreur ! Smart cast to 'User' is impossible\n            // car currentUser est un var et a pu changer\n            println(currentUser.name)\n        }\n    }\n}

Quel est le problème ? Nous venons pourtant de vérifier que currentUser n'est pas null ! Le compilateur répond : « Mon ami, tu utilises var. Cela signifie qu'entre la vérification et l'appel à println, un autre thread (ou même ce même code ailleurs) a pu remettre currentUser à null. Je ne peux pas prendre le risque — et si on avait un NPE ? ».

Et c'est juste ! Kotlin est un langage avec une philosophie null-safe. Il ne vous laisse pas vous tirer une balle dans le pied. Même si vous êtes sûr que personne ne modifiera la propriété, le compilateur se couvre. C'est mieux que d'attraper une NullPointerException à l'exécution.

\n\n

Comment y remédier ? 5 méthodes éprouvées (édition 2025)

Bonne nouvelle : il existe plusieurs solutions, et elles sont toutes simples. Choisissez celle qui correspond le mieux à votre style de code et à la situation.

\n\n

1. Copie locale immuable (la plus fiable)

Le moyen le plus direct est de stocker la valeur dans un val (variable locale immuable). Le compilateur voit immédiatement que le val local ne sera modifié par personne, et le smart cast fonctionne :

fun printUserName() {\n    val user = currentUser\n    if (user != null) {\n        // Smart cast fonctionne ! user est un val local\n        println(user.name)\n    }\n}

Cette astuce est l'étalon-or. Elle est simple, lisible et ne nécessite aucune bibliothèque supplémentaire. En 2025, c'est toujours la méthode la plus recommandée.

\n\n

2. La fonction let (méthode élégante)

La fonction let est un excellent outil pour travailler avec des valeurs nullables. Elle exécute un bloc de code uniquement si l'objet n'est pas null, et à l'intérieur du bloc, l'objet est accessible en tant que it (ou on peut lui donner un nom) :