Kotlin结合JavaFX：属性绑定行为异常问题求助

问题描述 #

使用Kotlin开发JavaFX应用时遇到异常：当界面中不包含Button组件时，ComboBox绑定的属性监听器不会输出任何内容；只要Button存在（无需点击执行动作），监听器就能正常触发。

代码示例 #

import javafx.application.Application
import javafx.beans.property.SimpleObjectProperty
import javafx.event.ActionEvent
import javafx.event.EventHandler
import javafx.scene.Scene
import javafx.scene.control.Button
import javafx.scene.control.ComboBox
import javafx.scene.layout.Region
import javafx.scene.layout.VBox
import javafx.stage.Stage

fun main() {
    Application.launch(ExpRunner::class.java)
}

class ExpRunner : Application() {

    override fun start(primaryStage: Stage) {
        val myScene = Scene(buildView(), 400.0, 400.0)
        primaryStage.apply { title = "Strange" }
            .apply { scene = myScene }
        primaryStage.show()
    }

    fun buildView(): Region {
        val h = Holder()
        val cb = ComboBox<String>().apply { valueProperty().bindBidirectional(h.prop) }
            .apply { listOf("a", "b").forEach { items.add(it) } }
        h.prop.apply {
            addListener { _, _, v -> println("Prop value changed: $v") }
            return VBox(
                10.0,
                // 移除该行后，监听器不再触发
                Button("Check").apply { onAction = EventHandler<ActionEvent> { _ -> println(h.hashCode()) } },
                cb,
            )
        }
    }
}

class Holder {
    val prop = SimpleObjectProperty<String>("a")
}

重现步骤 #

• 运行程序，更改ComboBox的选中项，包含Button时会打印属性变更信息；
• 注释掉添加Button的代码，重新运行，更改选中项无任何输出。

原因解释 #

核心问题是Holder实例的垃圾回收（GC）导致监听器失效：

• 当界面包含Button时，Button的onAction事件处理器持有对h（Holder实例）的强引用，h不会被GC回收，其内部的prop属性及绑定的监听器能持续正常工作；
• 移除Button后，h只是buildView函数的局部变量，函数执行完毕后，唯一的引用来自ComboBox与h.prop的双向绑定。但JavaFX的绑定机制不会为h保留强引用，导致h被GC回收。一旦h被回收，其prop属性上的监听器也随之失效，自然无法输出变更日志。

解决方案 #

让Holder实例保留强引用即可，比如将h声明为Application类的成员变量，而不是局部变量：

class ExpRunner : Application() {
    // 将Holder实例作为成员变量，确保强引用持有
    private val h = Holder()

    override fun start(primaryStage: Stage) {
        val myScene = Scene(buildView(), 400.0, 400.0)
        primaryStage.apply { title = "Fixed" }
            .apply { scene = myScene }
        primaryStage.show()
    }

    fun buildView(): Region {
        val cb = ComboBox<String>().apply { valueProperty().bindBidirectional(h.prop) }
            .apply { listOf("a", "b").forEach { items.add(it) } }
        h.prop.addListener { _, _, v -> println("Prop value changed: $v") }
        // 无需Button也能正常触发监听器
        return VBox(10.0, cb)
    }
}

内容的提问来源于stack exchange，提问作者MakerC