升级Primefaces至10后，jQuery3.x引发页面加载慢及部署异常问题

核心问题拆解 #

1. 页面加载慢/卡顿根源：Primefaces 6.2+升级的jQuery 3.x与原有window.load绑定逻辑冲突。jQuery 3.x优化了DOM解析时序，document.ready触发时机远早于jQuery 2.x，经常在window.load（所有资源加载完成）之后执行，导致你在document.ready内部绑定的window.load事件无法触发，加载动画持续显示，用户感知为页面加载缓慢或卡住。
2. 部署异常原因：自定义引入jQuery 2.2.4打破了Primefaces 10的资源依赖链，Primefaces的资源处理器无法正确解析组件与jQuery的依赖关系，导致部署时静默失败；拆分代码后全局暴露$(window).on("load")，会在Primefaces初始化前执行，进一步干扰资源加载顺序。

分步解决方案 #

1. 修复window.load绑定逻辑（解决加载慢） #

保留jQuery(document).ready包装，同时增加window.load触发状态判断，兼容jQuery 3.x的时序变化：

jQuery(document).ready(function ($) {
    // 判断window是否已完成加载
    if (document.readyState === 'complete') {
        hideLoader();
    } else {
        $(window).on("load", hideLoader);
    }
});

function hideLoader() {
    setTimeout(function () {
        $(LOADER).fadeOut('slow');
    }, LOADER_DELAY);
}

• 优势：既避免了事件绑定滞后的问题，又不会破坏Primefaces的JS加载顺序，同时去掉了冗余的空回调函数。

2. 解决服务器部署异常 #

• 禁止自定义替换jQuery：Primefaces 10依赖特定版本的jQuery，强行替换会导致组件JS与jQuery版本不兼容，引发资源解析错误（容器无报错是因为Primefaces的资源处理器静默处理了依赖缺失）。
• 规范资源加载方式：将menu.js放在resources/default/js/目录下，在页面中通过Primefaces的资源机制引入，确保JS在Primefaces的jQuery之后加载：

<h:outputScript name="default/js/menu.js" target="body"/>

• 清理构建缓存：部署前彻底清理Maven/Gradle构建缓存，以及服务器临时资源目录（如Tomcat的work目录），避免旧版本资源残留。

3. 额外性能优化 #

• 替换全局变量：将LOADER全局选择器改为在函数内直接获取，避免全局变量污染：

function hideLoader() {
    setTimeout(function () {
        $('#your-loader-id').fadeOut('slow'); // 替换为实际加载器ID
    }, LOADER_DELAY);
}

• 启用Primefaces资源压缩：在web.xml中添加配置，减少资源加载体积：

<context-param>
    <param-name>primefaces.RESOURCE_COMPRESSION</param-name>
    <param-value>true</param-value>
</context-param>
<context-param>
    <param-name>primefaces.MINIFIED_RESOURCES</param-name>
    <param-value>true</param-value>
</context-param>

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