如何从HTP包生成的HTML页面向ADF JSF传参并解决相关报错

这个问题我之前帮不少开发者排查过，ADF_FACES-30179这个错误本质上是JSF生命周期的RESTORE_VIEW阶段没正确初始化——你的jQuery跳转方式绕过了ADF需要的视图上下文，导致UIViewRoot对象没创建出来。结合你是用PLSQL HTP生成邮件HTML的场景，给你几个可行的方案：

1. 直接使用带参数的GET请求跳转（最稳妥方案） #

邮件里的HTML链接天然适合用GET请求传递参数，ADF JSF页面可以直接通过EL表达式或后台代码获取参数，完全不会触发视图初始化问题：

• 在PLSQL的HTP代码里生成普通的锚点链接，示例：

  HTP.P('<a href="http://your-adf-domain/faces/YourTargetPage.jsf?userId=' || UTL_URL.ESCAPE('123') || '&orderNo=' || UTL_URL.ESCAPE('ORD-456') || '">查看订单详情</a>');
  

  注意一定要用UTL_URL.ESCAPE处理参数值，避免特殊字符（比如空格、中文）导致URL解析错误。
• 在ADF页面中获取参数：
  • 直接在页面组件用EL表达式：#{param.userId}
  • 在后台Bean中通过ExternalContext获取：

    FacesContext facesCtx = FacesContext.getCurrentInstance();
    String userId = facesCtx.getExternalContext().getRequestParameterMap().get("userId");
    

2. 利用ADF的书签（Bookmarkable）特性传递参数 #

如果你的ADF页面是基于任务流开发的，可以开启任务流的书签功能，让URL更规范且能被ADF正确识别：

• 在任务流的配置文件（.jspx或.task-flow）中设置bookmarkable="true"，并定义需要传递的参数：

  <task-flow-definition id="YourTaskFlow">
      <input-parameter-definition>
          <name>userId</name>
          <class>java.lang.String</class>
          <pass-by-value>true</pass-by-value>
      </input-parameter-definition>
      <default-activity>YourPage</default-activity>
      <bookmarkable>true</bookmarkable>
  </task-flow-definition>
  

• 生成对应的跳转URL：http://your-adf-domain/faces/YourTaskFlow?userId=123，ADF会自动处理视图状态，不会出现UIViewRoot为空的问题。

3. 避免用jQuery的AJAX或非常规跳转方式 #

你之前用jQuery出现错误，大概率是因为用了AJAX请求或者不完整的跳转逻辑（比如只修改location.pathname而没带完整的JSF页面路径）。ADF的RESTORE_VIEW阶段需要完整的请求上下文，所以：

• 替换jQuery跳转为原生JS的完整URL跳转：

  // 正确写法
  window.location.href = 'http://your-adf-domain/faces/YourTargetPage.jsf?param=value';
  

• 尽量优先用HTML原生的<a>标签，不要用JS动态生成跳转逻辑，减少上下文丢失的概率。

4. 检查ADF页面的视图状态配置 #

确保你的JSF页面没有禁用视图状态，这也是导致UIViewRoot为空的常见原因：

• 在faces-config.xml中确认视图处理器是ADF的默认实现：

  <application>
      <view-handler>oracle.adf.view.rich.richViewHandler</view-handler>
  </application>
  

• 不要给页面或任务流设置stateless="true"，除非你明确需要无状态模式（无状态模式下不会创建UIViewRoot）。

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