Eclipse 2023中Jakarta Server Faces 4.0的XHTML代码提示失效求助

一、搞定JSF Facet的命名空间适配 #

Eclipse自带的JSF Facet只支持旧版javax命名空间的JSF（最高到2.3），但Jakarta EE 10的JSF 4.0已经完全迁移到jakarta.faces命名空间，这就是出现javax.faces.FactoryFinder缺失错误的原因，按以下步骤调整：

• 先移除旧的JSF Facet：右键项目→Properties→Project Facets，取消勾选JavaServer Faces，点击应用保存。
• 手动修改Facet配置文件：
  1. 打开项目根目录下的.settings/org.eclipse.wst.common.project.facet.core.xml
  2. 将原有JSF相关配置替换为：

  <installed facet="jst.jsf" version="4.0">
    <runtime name="MyFaces 4.0.1 (Jakarta)" />
  </installed>
  

  3. 同时确认jst.web版本与Dynamic Web Module 5.0匹配：

  <installed facet="jst.web" version="5.0" />
  

• 刷新项目配置：右键项目→Refresh，或执行Maven→Update Project并勾选Force Update of Snapshots/Releases。

二、确保Maven依赖被Eclipse正确解析 #

Content Assist失效的核心原因通常是Eclipse未正确识别Jakarta EE相关依赖：

• 检查MyFaces依赖，必须使用4.0.x版本的Jakarta适配坐标：

  <dependency>
    <groupId>org.apache.myfaces.core</groupId>
    <artifactId>myfaces-api</artifactId>
    <version>4.0.1</version>
  </dependency>
  <dependency>
    <groupId>org.apache.myfaces.core</groupId>
    <artifactId>myfaces-impl</artifactId>
    <version>4.0.1</version>
  </dependency>
  

• PrimeFaces必须使用带jakarta分类器的版本（最低12.0）：

  <dependency>
    <groupId>org.primefaces</groupId>
    <artifactId>primefaces</artifactId>
    <version>13.0.0</version>
    <classifier>jakarta</classifier>
  </dependency>
  

• 执行Maven→Update Project后，去Project Properties→Java Build Path→Libraries确认Jakarta相关jar包已被加载。

三、开启Jakarta EE专属Content Assist规则 #

即使依赖正确，Eclipse可能默认未开启Jakarta相关的代码提示：

• 打开Window→Preferences→Web→JavaServer Faces→JSF Content Assist
• 在Enabled Libraries中勾选MyFaces 4.0.x和PrimeFaces的Jakarta版本
• 切换到Facelets标签，勾选Enable Facelets Content Assist，并确认命名空间映射正确（比如p:对应PrimeFaces）
• 后台Bean提示配置：打开Window→Preferences→Java→Editor→Content Assist→Advanced，确保Java Proposals和Jakarta EE Proposals均启用

四、验证目标运行时配置 #

TomEE WebProfile 9.1.0本身支持Jakarta EE 10，但需确保Eclipse运行时配置无误：

• 右键项目→Properties→Targeted Runtimes，确认仅勾选TomEE 9.1.0，避免混合旧版Tomcat/JEE运行时
• 若运行时中缺少MyFaces 4.0库，可手动添加：点击Add→New Runtime，选择TomEE 9.1.0并指定正确安装路径

五、清理Eclipse缓存（终极方案） #

若以上步骤均无效，清理缓存可解决多数配置识别问题：

• 执行Project→Clean，选择当前项目进行清理
• 关闭Eclipse，删除工作目录下的.metadata/.plugins/org.eclipse.core.resources/.projects/[你的项目名]（建议先备份重要配置）
• 重新打开Eclipse并导入项目

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