Εισαγωγή

Κατά την ανάπτυξη του plugin GradleΑρτοποιείοΓια το blog μου JBake, συνάντησα μια φαινομενικά απλή πρόβλημα: ένας έλεγχος μονάδας που απέτυχε με το λάθος.Wanted but not invoked. Το φαινόταν ένα απλό bug και έδειξε ότι είναι ένα παράδειγμα διδασκαλίας για να καταλάβουμε τις λεπτομέρειες του mocking με το Mockito και το Kotlin.

Στο άρθρο αυτό, σας οδηγώ σε ένα μεθοδικό ταξίδι debugging, όπου κάθε λύση αποκαλύπτει ένα νέο πρόβλημα, μέχρι την τελική λύση.

Το πλαίσιο : Plugin Gradle Bakery

Το πρόσθετο Bakery είναι ένα wrapper γύρω από το JBake που διευκολύνει τη δημοσίευση στατικών ιστοτόπων. Αυτό είναι η απλοποιημένη δομή του:

class BakeryPlugin : Plugin<Project> {
    override fun apply(project: Project) {
        val extension = project.extensions.create(
            "bakery",
            BakeryExtension::class.java
        )

        project.afterEvaluate {
            if (!project.layout.projectDirectory.asFile
                    .resolve(extension.configPath.get()).exists()) {
                println("config file does not exists")
            } else {
                // C'EST ICI QUE ÇA SE PASSE
                project.plugins.apply(JBakePlugin::class.java)

                val site = FileSystemManager.from(project, extension.configPath.get())
                // Configuration de JBake...
            }
        }
    }
}

Ο τεστ που απέτυχε ήταν απλό :

@Test
fun `plugin applies jbake gradle plugin`() {
    val project = createMockProject()
    val plugin = BakeryPlugin()

    plugin.apply(project)

    verify(project.plugins).apply(JBakePlugin::class.java)
}

Το σφάλμα:

Wanted but not invoked:
pluginContainer.apply(class org.jbake.gradle.JBakePlugin);
Actually, there were zero interactions with this mock.

Πρόβλημα #1 : Ελέγξτε το λάθος mock

Η διάγνωση

mockito problem 1

Το πρόβλημα: Mockito δεν μπορεί να παρακολουθήσει τις αλληλεπιδράσεις σε`project.plugins`επειδή είναι μόνο un getter που επιστρέφει το πραγματικό mock`mockPluginContainer`. Ο έλεγχος πρέπει να γίνει άμεσα στο παράδειγμα του mock.

Η λύση

Τροποποίηση`createMockProject()`για να επιστρέψει τα δύο αντικείμενα :

private fun createMockProject(): Pair<Project, PluginContainer> {
    val mockPluginContainer = mock<PluginContainer>()
    val mockProject = mock<Project> {
        on { plugins } doReturn mockPluginContainer
    }
    return Pair(mockProject, mockPluginContainer)
}

Και προσαρμόστε την δοκιμή :

@Test
fun `plugin applies jbake gradle plugin`() {
    val (project, mockPluginContainer) = createMockProject()
    val plugin = BakeryPlugin()

    plugin.apply(project)

    // ✅ Vérification directe sur le bon mock
    verify(mockPluginContainer).apply(JBakePlugin::class.java)
}

Πρόβλημα #2: UnfinishedStubbingException σε καскаδο

Η διάγνωση

Μετά την εφαρμογή της πρώτης διόρθωσης, εμφανίστηκε ένα νέο σφάλμα:

UnfinishedStubbingException:
Unfinished stubbing detected here
Hints:
 3. you are stubbing the behaviour of another mock inside
    before 'thenReturn' instruction is completed

Το προβληματικό κώδικα χρησιμοπούσε τη σύνταξη DSL του Mockito-Kotlin :

val mockProject = mock<Project> {
    on { extensions } doReturn mockExtensionContainer
    on { plugins } doReturn mockPluginContainer
    on { logger } doReturn mock()  // ❌ PROBLÈME ICI !
}
mockito problem 2

Η λύση

Δημιουργώόλοιτα mocks εκτός από κάθε μπλοκ stubbing, στη συνέχεια τα ρυθμίζουμε με`whenever()`:

private fun createMockProject(): Pair<Project, PluginContainer> {
    // 1️⃣ Créer TOUS les mocks d'abord
    val mockPluginContainer = mock<PluginContainer>()
    val mockExtensionContainer = mock<ExtensionContainer>()
    val mockLogger = mock<org.gradle.api.logging.Logger>()
    val mockProject = mock<Project>()

    // 2️⃣ Configurer les mocks séparément avec whenever()
    whenever(mockProject.plugins).thenReturn(mockPluginContainer)
    whenever(mockProject.extensions).thenReturn(mockExtensionContainer)
    whenever(mockProject.logger).thenReturn(mockLogger)

    return Pair(mockProject, mockPluginContainer)
}

Χρυσό κανόνα: Μην καλείς ποτέ`mock()`Μέσα σε ένα μπλοκ ρύθμισης mock. Πάντα δημιουργείτε τα mocks πρώτα, στη συνέχεια τα ρυθμίζετε.

Πρόβλημα #3 : Το αρχείο ρυθμίσεων δεν υπάρχει

Η διάγνωση

Ακόμη και με τους σωστούς mocks, ο έλεγχος απέτυχε συνέχεια επειδή το plugin δεν ήταν σε θέση να βρει το αρχείο ρυθμίσεων:

// Dans BakeryPlugin.kt
if (!project.layout.projectDirectory.asFile
        .resolve(extension.configPath.get()).exists()) {
    println("config file does not exists")
    return@afterEvaluate  // ❌ Sort avant d'appliquer JBake !
}
mockito problem 3

Η λύση

�Ρυθμίστε τα mocks ώστε η επίλυση του μονοπατιού να λειτουργεί:

private fun createMockProject(): Pair<Project, PluginContainer> {
    // ... autres mocks ...

    val configFile = File("../../site.yml").canonicalFile
    val projectDir = configFile.parentFile

    // Configuration cohérente des chemins
    whenever(mockConfigPathProperty.get()).thenReturn("site.yml")
    whenever(mockProjectDirectory.asFile).thenReturn(projectDir)

    // Maintenant : projectDir.resolve("site.yml") existe ! ✅
}
Failed to generate image: PlantUML preprocessing failed: [From <input> (line 16) ]

@startuml

rectangle "Μοκ διαμόρφωση" {
    card "projectDirectory.asFile" #90EE90
    card "returns: /real/path/to/project" #90EE90

    card "configPath.get()" #90EE90
    card "αποδόσεις: site.yml" #90EE90

    card "resolve()" #90EE90
    card "/real/path/to/project/site.yml" #90EE90

    card "import sys
sys.stdout.write(sys.stdin.read())" #90EE90
^^^^^
 Syntax Error? (Assumed diagram type: activity)

@startuml
!define SUCCESS #90EE90
!define PROBLEM #FFB6C1

rectangle "Μοκ διαμόρφωση" {
    card "projectDirectory.asFile" SUCCESS
    card "returns: /real/path/to/project" SUCCESS

    card "configPath.get()" SUCCESS
    card "αποδόσεις: site.yml" SUCCESS

    card "resolve()" SUCCESS
    card "/real/path/to/project/site.yml" SUCCESS

    card "import sys
sys.stdout.write(sys.stdin.read())" SUCCESS
    card "true ✅" SUCCESS
}
@enduml

Πρόβλημα #4 : afterEvaluate και NullPointerException

Η διάγνωση

Το πρόσθετο εφαρμόζει το JBake σε ένα μπλοκ`afterEvaluate`, και έχει πρόσβαση σε`buildDirectory.dir()`:

project.afterEvaluate {
    // ...
    project.tasks.withType(JBakeTask::class.java)
        .getByName("bake").apply {
            output = project.layout.buildDirectory
                .dir(site.bake.destDirPath)  // ❌ NPE ici !
                .get()
                .asFile
        }
}

Το mock του`buildDirectory.dir()επιστρέφε`null.

Η λύση

να χλευάζω`afterEvaluate`για να τρέχει αμέσως, και να το ρυθμίσουμε πλήρως`buildDirectory` :

private fun createMockProject(): Pair<Project, PluginContainer> {
    // ... autres mocks ...

    val mockBuildDirectory = mock<DirectoryProperty>()
    val buildDir = File(projectDir, "build")

    // Mocker dir() pour retourner un Provider valide
    whenever(mockBuildDirectory.dir(any<String>())).doAnswer { invocation ->
        val path = invocation.arguments[0] as String
        val mockDirProvider = mock<Provider<Directory>>()
        val mockDir = mock<Directory>()

        whenever(mockDir.asFile).thenReturn(File(buildDir, path))
        whenever(mockDirProvider.get()).thenReturn(mockDir)

        mockDirProvider
    }

    // Mocker afterEvaluate pour exécution immédiate
    whenever(mockProject.afterEvaluate(any<Action<Project>>())).doAnswer { invocation ->
        val action = invocation.arguments[0] as Action<Project>
        action.execute(mockProject)  // ✅ Exécution synchrone
        null
    }

    return Pair(mockProject, mockPluginContainer)
}
after evaluate flow

Η πλήρης λύση

Αυτή είναι η συνάρτηση`createMockProject()`τελίκη, που λύνει όλα τα προβλήματα:

private fun createMockProject(): Pair<Project, PluginContainer> {
    // 1️⃣ CRÉER tous les mocks (pas de nested mocks !)
    val mockPluginContainer = mock<PluginContainer>()
    val mockExtensionContainer = mock<ExtensionContainer>()
    val mockLogger = mock<org.gradle.api.logging.Logger>()
    val mockTaskContainer = mock<TaskContainer>()
    val mockConfigPathProperty = mock<Property<String>>()
    val mockBakeryExtension = mock<BakeryExtension>()
    val mockProjectDirectory = mock<Directory>()
    val mockBuildDirectory = mock<DirectoryProperty>()
    val mockProjectLayout = mock<ProjectLayout>()
    val mockProject = mock<Project>()

    // 2️⃣ CONFIGURER la résolution des chemins
    val configFile = File("../../site.yml").canonicalFile
    val projectDir = configFile.parentFile
    val buildDir = File(projectDir, "build")

    whenever(mockConfigPathProperty.get()).thenReturn("site.yml")
    whenever(mockConfigPathProperty.isPresent).thenReturn(true)
    whenever(mockBakeryExtension.configPath).thenReturn(mockConfigPathProperty)
    whenever(mockProjectDirectory.asFile).thenReturn(projectDir)

    // 3️⃣ CONFIGURER buildDirectory avec dir()
    whenever(mockBuildDirectory.dir(any<String>())).doAnswer { invocation ->
        val path = invocation.arguments[0] as String
        val mockDirProvider = mock<Provider<Directory>>()
        val mockDir = mock<Directory>()
        whenever(mockDir.asFile).thenReturn(File(buildDir, path))
        whenever(mockDirProvider.get()).thenReturn(mockDir)
        mockDirProvider
    }

    // 4️⃣ ASSEMBLER le projet
    whenever(mockProjectLayout.projectDirectory).thenReturn(mockProjectDirectory)
    whenever(mockProjectLayout.buildDirectory).thenReturn(mockBuildDirectory)

    whenever(mockExtensionContainer.create("bakery", BakeryExtension::class.java))
        .thenReturn(mockBakeryExtension)
    whenever(mockExtensionContainer.getByType(BakeryExtension::class.java))
        .thenReturn(mockBakeryExtension)

    whenever(mockProject.extensions).thenReturn(mockExtensionContainer)
    whenever(mockProject.plugins).thenReturn(mockPluginContainer)
    whenever(mockProject.tasks).thenReturn(mockTaskContainer)
    whenever(mockProject.layout).thenReturn(mockProjectLayout)
    whenever(mockProject.logger).thenReturn(mockLogger)
    whenever(mockProject.projectDir).thenReturn(projectDir)

    // 5️⃣ CONFIGURER afterEvaluate pour exécution immédiate
    whenever(mockProject.afterEvaluate(any<Action<Project>>())).doAnswer { invocation ->
        val action = invocation.arguments[0] as Action<Project>
        action.execute(mockProject)
        null
    }

    return Pair(mockProject, mockPluginContainer)
}

Και η τελική δοκιμή που περνά:

@Test
fun `plugin applies jbake gradle plugin`() {
    val (project, mockPluginContainer) = createMockProject()
    val plugin = BakeryPlugin()

    plugin.apply(project)

    verify(mockPluginContainer).apply(JBakePlugin::class.java) // ✅ SUCCÈS !
}

Μαθήματα που έχουμε μάθει

lessons learned

1. Ελέγξτε το σωστό mock

// ❌ FAUX
verify(project.plugins).apply(JBakePlugin::class.java)

// ✅ CORRECT
val (project, mockPluginContainer) = createMockProject()
verify(mockPluginContainer).apply(JBakePlugin::class.java)

2. Αποφυγή των έμμεσων mocks

// ❌ FAUX - UnfinishedStubbingException
val mockProject = mock<Project> {
    on { logger } doReturn mock()  // Nested mock creation !
}

// ✅ CORRECT - Créer séparément
val mockLogger = mock<org.gradle.api.logging.Logger>()
val mockProject = mock<Project>()
whenever(mockProject.logger).thenReturn(mockLogger)

3. Μόκαρε τα callbacks αξιολόγησης

// ✅ afterEvaluate doit s'exécuter pour les tests
whenever(mockProject.afterEvaluate(any())).doAnswer { invocation ->
    val action = invocation.arguments[0] as Action<Project>
    action.execute(mockProject)
    null
}

4. Δοκιμή της επίλυσης των διαδρομών

// Toujours vérifier que les chemins se résolvent correctement
val extension = project.extensions.getByType(BakeryExtension::class.java)
val configPath = extension.configPath.get()
val projectDir = project.layout.projectDirectory.asFile
val resolvedConfig = projectDir.resolve(configPath)

println("Resolved config: ${resolvedConfig.absolutePath}")
println("Exists: ${resolvedConfig.exists()}")

Τελική δοκιμαστική αρχιτεκτονική

test architecture

Συμπέρασμα

Το που φαινόταν να είναι ένα απλό πρόβλημα δοκιμής έδειξε ότι ήταν ένα εξαιρετικό υπόθεση μελέτης για :

  • Οι λεπτομέρειες του Mockito με Kotlin

  • Η σημασία του να κάνουμε mock στα σωστά αντικείμενα

  • Η διαχείριση των ασυγχρονών callbacks στα tests

  • Η επίλυση διαδρομών στα πρόσθετα Gradle

Η μεθοδική αποσφαλμάτωση, κατανόοντας κάθε επίπεδο του προβλήματος, οδήγησε σε μια ανθεκτική και διατηρήσιμη λύση.

Συμβουλή για τα τεστ σαςΕάν συναντήσετε το "Wanted but not invoked" με το Mockito, πάντα ρωτήστε τον εαυτό σας: 1. Έλεγχω το σωστό mock ? 2. Είναι όλα τα mocks μου δημιουργημένα εκτός των μπλοκ ρυθμίσεων; 3. Τρέχουν πραγματικά οι callbacks μου; 4. Οι διαδρομές μου λύνονται σωστά;

Πόροι


Έχετε συναντήσει προβλήματα παρόμοια στα δοκιμαστικά σας; Μοιραστείτε την εμπειρία σας στα σχόλια!

Σχετικά άρθρα