JBoss 5.1服务器下Facelets代码修改无法热发布问题求助

我之前在JBoss 5.1上开发JSF应用时也碰到过一模一样的问题——Java代码改了能立马热更，但Facelets的xhtml文件怎么改都不生效，重启服务器、关Eclipse都没用。给你几个实用的排查和解决方向：

• 检查Facelets的刷新周期配置：JBoss默认会对Facelets文件做永久缓存，这是导致修改不生效的常见原因。你可以在项目的web.xml里添加或修改以下参数，强制Facelets每次请求都检查文件变化：

  <context-param>
      <param-name>javax.faces.FACELETS_REFRESH_PERIOD</param-name>
      <param-value>0</param-value>
  </context-param>
  

  参数值0表示每次请求都刷新，开发环境非常适用；如果觉得太频繁，也可以设为1（每隔1秒检查一次）。

• 确认Eclipse的部署同步设置：有时候Eclipse并没有把Facelets文件的修改同步到JBoss的部署目录里。你可以先手动去JBoss的server/default/deploy/你的应用名称/路径下，看看对应的xhtml文件是不是最新的。如果不是：

  1. 右键项目 → Properties → Deployment Assembly，确认Facelets文件所在的目录（比如WebContent下的xhtml文件）已经被包含在部署路径中；
  2. 在Eclipse的Server视图里，右键你的JBoss服务器 → Publish，选择「Full Publish」强制同步所有文件。

• 清理JBoss的临时编译缓存：JBoss会把编译后的Facelets文件存放在临时目录里，就算你修改了原文件，缓存的编译版本可能还在生效。你可以找到server/default/work/jboss.web/localhost/你的应用名称/这个目录，删掉里面的所有文件，然后重启服务器，这样JBoss就会重新编译你的Facelets文件。

• 检查JSF的项目阶段设置：如果web.xml里把javax.faces.PROJECT_STAGE设成了Production（生产模式），Facelets的缓存机制会更严格。改成Development（开发模式）就能自动开启更多的调试和刷新功能：

  <context-param>
      <param-name>javax.faces.PROJECT_STAGE</param-name>
      <param-value>Development</param-value>
  </context-param>
  

你可以按这个顺序一个个试，大部分情况下前两个步骤就能解决问题啦！

备注：内容来源于stack exchange，提问作者Lolloroma114