Spring Boot打jar包时如何创建引用static目录的Wicket自定义CssResourceReference

算力阿峰

2026-10-6

核心原因

Wicket的CssResourceReference本质是从类路径加载和基准类绑定的资源，不是走Spring Boot的HTTP静态资源映射逻辑：

你传入的第一个参数WicketApplication.class是资源查找的基准类，默认会在这个类的classpath同目录下查找第二个参数指定的文件
你之前放在webapp或者resources/static下的资源，不符合Wicket ResourceReference的类路径查找规则，所以无法识别

解决方案

方案1：按Wicket默认规则存放（推荐）

资源存放路径：在src/main/resources下创建和WicketApplication类包路径完全一致的目录，比如你的WicketApplication在com.example.demo包下，就创建src/main/resources/com/example/demo目录，把css、js文件放到这个目录里
代码调整：去掉CssResourceReference第二个参数开头的斜杠，直接写文件名：

public static final CssResourceReference jqueryUiLayoutDefaultCss =
        new CssResourceReference(WicketApplication.class,
                "layout-default.min.css");

public static final CssResourceReference formDefaultCss =
        new CssResourceReference(WicketApplication.class,
                "default-form.min.css");

调用方式保持不变即可：

response.render(CssHeaderItem.forReference(formDefaultCss));

方案2：保留资源在static目录

如果你不想移动已经放在src/main/resources/static下的资源，只需要修改CssResourceReference的第二个参数，补全类路径下的完整路径即可：

public static final CssResourceReference formDefaultCss =
        new CssResourceReference(WicketApplication.class,
                "/static/default-form.min.css");