PrimeFaces 13 BlockUI生产环境提前消失问题求助

当前技术栈：PrimeFaces 13 + JBoss 7.4 + Java 11
需求：通过BlockUI组件在耗时超10分钟的批量事务完成前阻塞整个表单
问题现象：

• 升级前（PrimeFaces 6 + JBoss 7.2 + Java 8）所有环境运行正常
• 升级后，DEV环境BlockUI可保持到事务结束，但生产环境中加载面板数分钟后自行消失，后台进程仍在运行

调用BlockUI的代码：

onstart="PF('blockUi2').show()" oncomplete="PF('blockUi2').hide()"

阻塞表单的代码：

<p:blockUI block="data" id="mqp-blockui" widgetVar="blockUi2" >
    <img style="height:8em;background-color:transparent !important;" src="#{facesContext.externalContext.requestContextPath}/themes/default/pics/loading.gif">
</p:blockUI>

1. 检查生产环境HTTP会话超时配置 #

生产环境JBoss的HTTP会话超时可能设置过短，当请求耗时超过会话超时时间，会话失效会导致PrimeFaces组件状态丢失，BlockUI自动关闭。

• 调整JBoss web.xml中<session-config>的<session-timeout>值，设为大于事务最长耗时（比如15分钟以上）
• 或者添加会话心跳逻辑，通过定期发送小型AJAX请求维持会话状态

2. 调整PrimeFaces AJAX超时 #

PrimeFaces 13的AJAX默认超时可能比旧版本更短，生产环境服务器负载高或网络延迟时，请求未完成就触发超时，导致oncomplete提前执行。

• 在页面h:head中配置全局AJAX超时：

PrimeFaces.settings.ajax.timeout = 7200000; // 设为120分钟，按需调整

• 或在触发批量事务的AJAX组件上单独设置timeout属性：

<p:commandButton ... timeout="7200000" />

3. 检查反向代理/负载均衡超时 #

如果生产环境使用Nginx、Apache等代理设备，可能配置了请求超时时间，超过后会主动断开连接，前端误以为请求完成，触发BlockUI隐藏。

• 调整代理设备的超时参数，比如Nginx的proxy_connect_timeout、proxy_read_timeout，设为大于事务最长耗时

4. 改用手动轮询控制BlockUI #

避免依赖AJAX的onstart/oncomplete，改用手动控制逻辑：

• 点击按钮时先显示BlockUI，然后定期轮询后台接口判断事务状态，完成后再隐藏：

function startBatchTask() {
    PF('blockUi2').show();
    const pollInterval = setInterval(() => {
        PF('taskStatusChecker').load().then(res => {
            if (res.jqXHR.responseText === 'FINISHED') {
                PF('blockUi2').hide();
                clearInterval(pollInterval);
            }
        });
    }, 30000); // 每30秒轮询一次
}

• 后台需提供一个查询任务状态的接口，返回任务是否完成

5. 适配PrimeFaces 13组件变更 #

PrimeFaces 13对BlockUI组件可能有行为调整，比如widgetVar处理逻辑变化：

• 排查页面中是否有其他JS代码意外调用PF('blockUi2').hide()
• 尝试用组件ID替代widgetVar获取实例：

onstart="PF('mqp-blockui').show()" oncomplete="PF('mqp-blockui').hide()"

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