使用JSF+Spring+PrimeFaces打开页面时PrimeFaces主题资源找不到异常

我之前帮不少用Spring WebFlow+PrimeFaces的开发者解决过这个问题，你遇到的核心问题就是Spring WebFlow的请求拦截规则和PrimeFaces的资源路径解析冲突了——WebFlow把PrimeFaces的主题资源请求给拦截了，还错误地把路径解析成带*的格式，导致找不到对应的资源文件。

先给你几个针对性的解决方案，按顺序试就行：

1. 让Spring WebFlow放行JSF/PrimeFaces资源 #

这是最常见的解决办法，你需要在Spring WebFlow的配置文件（比如spring-webflow-config.xml）里，明确排除对JSF和PrimeFaces资源的拦截：

<webflow:flow-handler-mapping>
    <webflow:flow-location-pattern value="/**" />
    <!-- 排除JSF核心资源请求 -->
    <webflow:exclude-mapping path="/javax.faces.resource/**" />
    <!-- 排除PrimeFaces专属资源请求 -->
    <webflow:exclude-mapping path="/primefaces/**" />
</webflow:flow-handler-mapping>

这样WebFlow就不会插手这些资源请求，而是让JSF的原生资源处理器来处理，自然就不会生成带星号的错误路径了。

2. 检查PrimeFaces主题配置是否正确 #

确认你的faces-config.xml或者web.xml里的主题配置没有问题，比如用内置主题的话应该是这样：

<context-param>
    <param-name>primefaces.THEME</param-name>
    <param-value>aristo</param-value> <!-- 换成你想用的主题，比如bootstrap、saga等 -->
</context-param>

别在主题参数里加任何通配符，PrimeFaces会自动处理主题资源的路径映射。

3. 确认PrimeFaces依赖完整 #

如果是用Maven/Gradle管理依赖，要确保PrimeFaces的核心jar包正确引入——内置主题是包含在核心jar里的，不需要额外引入主题包（除非你用自定义主题）。比如Maven依赖：

<dependency>
    <groupId>org.primefaces</groupId>
    <artifactId>primefaces</artifactId>
    <version>你的PrimeFaces版本号</version>
</dependency>

4. 调整Spring MVC的资源映射（如果项目用了Spring MVC） #

如果你的项目同时集成了Spring MVC，也要确保Spring MVC不会拦截这些资源。在Spring MVC的XML配置里加：

<mvc:resources mapping="/javax.faces.resource/**" location="/javax.faces.resource/" />
<mvc:resources mapping="/primefaces/**" location="/primefaces/" />

要是用Java配置的话，就在配置类里重写addResourceHandlers方法：

@Override
public void addResourceHandlers(ResourceHandlerRegistry registry) {
    registry.addResourceHandler("/javax.faces.resource/**")
            .addResourceLocations("/javax.faces.resource/");
    registry.addResourceHandler("/primefaces/**")
            .addResourceLocations("/primefaces/");
}

补充说明 #

你日志里出现的/WEB-INF/*/javax.faces.resource/theme.xhtml路径里的星号，是因为Spring WebFlow在匹配请求时，错误地把PrimeFaces主题的动态路径变量解析成了通配符，只要让WebFlow放过这些资源请求，这个问题就会消失。

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