PrimeFaces 13迁移后页面垂直滚动条消失问题求助

PrimeFaces从6.x升级到13.x后，核心样式或主题默认行为的变化可能导致页面级滚动条失效，以下是针对性的解决方案：

1. 修复全局根元素样式 #

PrimeFaces 13部分默认主题可能将html/body的overflow设为hidden，或者未正确设置高度，导致内容溢出时无法触发滚动。在全局CSS文件中添加以下样式：

html, body {
    height: 100%;
    margin: 0;
    padding: 0;
    overflow-y: auto;
}

• height: 100%确保根元素能铺满视口高度
• overflow-y: auto会在内容超出视口时自动显示垂直滚动条

2. 调整PrimeFaces布局组件（若使用p:layout） #

如果项目使用了p:layout组件，PrimeFaces 13对其默认行为做了调整，需确保：

• 给p:layout添加fullPage="true"属性，使其绑定到视口尺寸
• 避免手动限制layoutUnit的固定高度，让内容自然溢出触发滚动：

<p:layout fullPage="true">
    <p:layoutUnit position="center">
        <!-- 页面内容 -->
    </p:layoutUnit>
</p:layout>

3. 排查自定义/主题样式冲突 #

检查项目中的自定义CSS或PrimeFaces主题样式，是否存在以下覆盖行为：

• 将某个顶级容器（如.ui-layout-container或自定义外层div）的overflow设为hidden
• 强制设置容器高度为100vh但未处理溢出

若发现此类样式，将其overflow修改为auto或移除强制高度限制即可。

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