JavaFX运行报错：初始化引导层出错 提示Module sample未找到

• 检查module-info.java存放位置：必须放在源码根目录（普通项目src目录、Maven/Gradle项目src/main/java目录）下，不能放入sample包内部，否则不会被识别为模块声明文件。
• 核对模块名一致性：确保module-info.java中声明的模块名sample无拼写、大小写错误，运行配置中涉及模块名的参数需和该名称完全匹配。
• 补充模块运行参数：使用模块模式启动时，需在VM选项中追加--module sample/主类全限定名，比如主类为sample.Main就追加--module sample/sample.Main，无需再单独在主类字段填写全类名。
• 验证编译输出：检查编译后的输出目录（如out/production/项目名、target/classes）中是否存在module-info.class文件，不存在的话重新构建项目，确认IDE开启了模块编译支持。
• 排查版本与依赖冲突：确认运行的JDK版本≥11，与JavaFX 17版本匹配；如果使用构建工具，不要同时配置本地JavaFX SDK路径和构建工具的JavaFX依赖，二者选其一即可避免冲突。
• 补充模块开放配置：如果FXML控制器存放在sample以外的包，需要额外追加对应包的开放声明，比如opens sample.controller to javafx.fxml;。

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