JSF自定义组件及模板在文件夹内页面无法渲染求助（Java EE/NetBeans）

我来帮你排查这个faces flow下页面无法渲染自定义组件和模板的问题，这种路径差异导致的渲染失败在JSF开发里挺常见的，咱们一步步来捋：

1. 先检查自定义组件的引用路径 #

如果你的自定义组件在根目录页面能正常渲染，但子文件夹页面不行，大概率是相对路径引用错误：

• 要是你用的是复合组件（放在Web Pages/resources/下），确保页面里的命名空间声明是绝对路径，比如：

  xmlns:my="http://xmlns.jcp.org/jsf/composite/components"
  

  这种声明不会因为页面所在目录变化而失效，别用相对路径的命名空间。
• 要是你用的是自定义taglib，检查taglib的URI引用：如果是本地文件，要用绝对路径（以/开头），比如：

  xmlns:my="/WEB-INF/tags/my-components.taglib.xml"
  

  别写成../WEB-INF/...这种相对路径，JSF解析子页面时会把相对路径当成基于当前页面目录的路径，自然找不到文件。

2. 修正模板的引用方式 #

模板失效几乎都是路径问题，记住一个原则：模板引用必须用绝对路径（从Web Pages根目录开始，以/开头）。
比如根目录页面里的模板引用是对的：

<ui:composition template="/templates/main-template.xhtml">

但子页面里如果写成了template="templates/main-template.xhtml"（没加开头的/），JSF会去registration/templates/下找模板，肯定找不到。把路径改成绝对路径就能解决。

3. 核对Faces Flow的配置 #

检查你的flow定义文件（比如registration-flow.xml）：

• 确认里面的视图节点路径是否正确，比如：

  <flow-definition id="registration">
      <view id="registration">
          <vdl-document>/registration/registration.xhtml</vdl-document>
      </view>
  </flow-definition>
  

  路径要确保是从Web Pages根开始的绝对路径。
• 另外，子页面里的JSF命名空间要完整，比如必须包含xmlns:ui="http://xmlns.jcp.org/jsf/facelets"，少了这个命名空间，ui:composition、ui:insert这些模板标签会被当成普通HTML标签，根本不会生效。

4. 清理NetBeans的部署缓存 #

有时候NetBeans的缓存会“记住”旧的路径配置，导致修改后不生效：

• 右键项目，选择Clean and Build，彻底清理编译文件和部署包。
• 如果用的是GlassFish或者Payara服务器，手动清理服务器缓存：找到服务器的domains/domain1/generated目录，删掉里面的所有内容，然后重启服务器。

5. 检查自定义组件的依赖资源 #

如果自定义组件依赖CSS、JS或者图片，也要确保这些资源的引用是正确的：

• 用JSF自带的资源标签加载，比如：

  <h:outputStylesheet name="css/my-component.css"/>
  <h:outputScript name="js/my-component.js"/>
  

  这种方式会自动从Web Pages/resources/目录下加载资源，不管页面在哪个子文件夹都能找到，别用相对路径的<link>或<script>标签。

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