IntelliJ中JavaFX背景图片加载失败：StyleManager报错排查

问题根源 #

控制台报错明确提示找不到样式表，核心原因是FXML中使用了基于本地文件系统的相对路径，而打包后资源的类路径与开发时的文件系统路径规则不一致。Scene Builder能正常识别是因为它直接读取本地文件，但Java运行时（尤其是打包成Jar后）通过类加载器读取资源，路径解析逻辑完全不同。

解决方案 #

1. 调整项目资源结构（关键） #

将CSS和图片资源从java目录移到resources目录（Maven/Gradle标准资源目录，IDEA/Eclipse默认会将其下文件打包到类路径中），最终结构如下：

src/main/
├── java/
│   └── com/example/fxmlcsia/
│       ├── main.java
│       └── logInPage.fxml
└── resources/
    ├── css/
    │   └── style.css
    └── images/
        └── background.jpg

2. 修改FXML中的样式表路径 #

把FXML里的stylesheets属性改为基于类路径的绝对路径（用@/表示类路径根目录）：

<AnchorPane ... stylesheets="@/css/style.css" ...>

3. 确认CSS中的图片路径 #

CSS里的路径是相对于CSS文件本身的位置，当前结构下原有路径无需修改，保持即可：

.root {
    -fx-background-image:url("../images/background.jpg");
    -fx-background-size:cover;
}

4. 确保资源被正确识别（IDEA用户） #

右键点击resources目录 → 选择Mark Directory as → Resources Root，确保IDEA将该目录下的文件视为可打包的资源。

额外检查 #

• 禁止使用文件系统绝对路径（如C:/xxx/xxx.jpg），否则打包后必然失效。
• 清理并重新构建项目，避免旧的打包缓存干扰结果。

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