JavaFX中ControllerFactory返回Kotlin单例时控制器初始化失败如何解决

• Kotlin 中object声明的单例类，所有成员属性和方法默认都是final（不可修改）的，且私有成员无法被FXML的反射逻辑访问。JavaFX的FXMLLoader需要通过反射给@FXML标注的字段动态赋值，final字段无法被反射修改，因此注入逻辑完全不生效，调用initialize方法时button还处于未初始化状态，抛出UninitializedPropertyAccessException异常。
• 额外问题：全局单例控制器不符合JavaFX的设计逻辑，若多次加载对应FXML，单例的字段只会被第一次加载赋值，后续加载会出现状态残留、注入失效的问题。

不要用object单例实现全局访问控制器的需求，改为加载FXML后获取控制器实例存入全局变量，既能满足全局访问的需求，也符合JavaFX的设计规范：

1. 修改控制器为普通类：

class Controller : Initializable {
    @FXML private lateinit var button: Button
    @FXML fun buttonAction() { println("Clicked") }

    override fun initialize(location: URL?, resources: ResourceBundle?) {
        button.text = "Click Me"
    }
}

2. 启动类中加载FXML后获取控制器存入全局变量：

class App: Application() {
    // 全局可访问的控制器实例
    companion object {
        lateinit var controller: Controller
            private set
    }

    override fun start(primaryStage: Stage) {
        val loader = FXMLLoader(javaClass.getResource("Window.fxml"))
        val root = loader.load<Parent>()
        // 从加载器中获取初始化完成的控制器实例
        controller = loader.getController()

        val scene = Scene(root, 400.0, 600.0)
        primaryStage.scene = scene
        primaryStage.show()
    }

    fun main(vararg args: String) {
        launch(*args)
    }
}

后续需要访问控制器时直接调用App.controller即可。

如果坚持要使用object单例作为控制器，需要给被注入的字段添加@JvmField注解取消Kotlin默认的字段封装，同时去掉private修饰符允许反射访问：

object Controller : Initializable {
    @FXML @JvmField var button: Button? = null
    @FXML fun buttonAction() { println("Clicked") }

    override fun initialize(location: URL?, resources: ResourceBundle?) {
        button?.text = "Click Me"
    }
}

该方案仅做兼容参考，存在多次加载FXML状态混乱的风险，不建议在生产环境使用。

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