GraphStream为Node节点设置fill-image填充图片不生效的解决方法

图片加载不生效是几个遗漏的必填配置和写法错误导致的，对应修复点如下：

• 依赖不全：仅引入gs-core包无法使用图片填充功能，必须额外引入同版本的gs-ui-swing依赖，核心包不包含图片资源解析、Swing端渲染的相关实现，图片填充逻辑不会被触发。对应Maven依赖：

<dependencies>
    <dependency>
        <groupId>org.graphstream</groupId>
        <artifactId>gs-core</artifactId>
        <version>2.0</version>
    </dependency>
    <dependency>
        <groupId>org.graphstream</groupId>
        <artifactId>gs-ui-swing</artifactId>
        <version>2.0</version>
    </dependency>
</dependencies>

• 本地路径解析错误：直接写相对路径data/assets/carIcon.png时，GraphStream会默认从类加载路径查找资源，不会按程序运行的工作目录解析文件。正确写法是将本地文件转为标准file协议URL，避免路径匹配失败：

File carIconFile = new File("data/assets/carIcon.png");
String carIconUrl = carIconFile.toURI().toString();

• 样式属性缺失：仅设置fill-mode和fill-image无法显示图片，GraphStream节点默认带灰色纯色填充，会完全覆盖上层的图片资源，必须补充fill-color: rgba(0,0,0,0);关闭默认纯色填充。如果需要图片等比缩放不被拉伸，建议将fill-mode设置为image-scaled-ratio-max，替代会拉伸变形的image-scaled。
• 远程URL加载限制：GraphStream默认资源加载器没有内置网络请求超时、HTTPS证书适配逻辑，直接在CSS中写入远程图片链接大概率会因为网络权限、证书校验失败加载中断。建议提前将远程图片下载到本地后按本地资源方式加载，或直接将读取到的BufferedImage对象作为属性传入节点，不要直接在样式中引用远程链接。

修正后的可运行代码示例：

import org.graphstream.graph.Graph;
import org.graphstream.graph.Node;
import org.graphstream.graph.implementations.SingleGraph;
import java.io.File;

public class Test {
    public static void main(String args[]) throws Exception {
        // 手动指定Swing渲染器，避免自动识别UI组件失败
        System.setProperty("org.graphstream.ui", "swing");
        Graph graph = new SingleGraph("Tutorial 1");

        Node A = graph.addNode("A");
        Node B = graph.addNode("B");
        Node C = graph.addNode("C");

        graph.addEdge("AB", "A", "B");
        graph.addEdge("BC", "B", "C");
        graph.addEdge("CA", "C", "A");

        File carIconFile = new File("data/assets/carIcon.png");
        String carIconUrl = carIconFile.toURI().toString();

        B.setAttribute("ui.style", String.join(";",
                "size: 50px",
                "fill-mode: image-scaled-ratio-max",
                "fill-color: rgba(0,0,0,0)",
                "fill-image: url('" + carIconUrl + "')"
        ));
        
        graph.display();
    }
}

排查提示：GraphStream资源加载失败不会主动抛出终止异常，只会在控制台输出静默错误日志，如果配置后还是看不到图片，优先看控制台有没有资源找不到、图片解码失败的报错信息，同时确认图片文件本身没有损坏、路径有可读权限。

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