PrimeFaces p:dataTable过滤无结果时不显示emptyMessage的解决方法

这个问题我之前在PrimeFaces 6.0里碰到过，确实是这个版本的一个已知小问题——过滤后无匹配数据时，组件没有正确识别空数据集状态，反而错误渲染了空的第一页。给你几个可行的解决办法：

方法一：手动维护数据集与分页状态（非懒加载场景） #

如果你的p:dataTable绑定的是普通List而非懒加载模型，可以在后端过滤逻辑里主动处理空结果的情况：

1. 在你的Bean里添加分页相关的属性并绑定到dataTable：

import java.util.Collections;
import java.util.List;
import javax.faces.view.ViewScoped;
import javax.inject.Named;

@Named
@ViewScoped
public class YourBean {
    private List<YourEntity> dataList;
    private List<YourEntity> filteredList;
    private int first; // 对应dataTable的first属性
    private int rows = 10; // 每页行数
    // 过滤器值、选项列表等其他属性

    public void onFilter() {
        // 执行你的过滤逻辑，得到过滤后的列表
        filteredList = yourCustomFilterLogic();
        
        if (filteredList.isEmpty()) {
            // 空结果时，设置数据集为空列表，重置分页起始位置
            dataList = Collections.emptyList();
            first = 0;
        } else {
            dataList = filteredList;
        }
    }

    // getter和setter方法
}

2. 页面上的dataTable要绑定first和rows属性，并确保emptyMessage正确设置：

<p:dataTable id="yourTable" value="#{yourBean.dataList}" var="item"
             emptyMessage="没有找到匹配的记录"
             first="#{yourBean.first}" rows="#{yourBean.rows}"
             filteredValue="#{yourBean.filteredList}"
             widgetVar="tableWidget">
    <!-- 带selectOneMenu过滤器的列示例 -->
    <p:column headerText="状态" filterBy="#{item.status}" filterMatchMode="exact">
        <h:outputText value="#{item.status}" />
        <f:facet name="filter">
            <p:selectOneMenu value="#{yourBean.statusFilter}" 
                             onchange="PF('tableWidget').filter();">
                <f:selectItem itemLabel="全部" itemValue="" />
                <f:selectItems value="#{yourBean.statusOptions}" />
            </p:selectOneMenu>
        </f:facet>
    </p:column>
    <!-- 其他列定义 -->
</p:dataTable>

核心是过滤后为空时，强制把数据集设为空列表并重置分页起始位，让组件正确识别空状态，从而显示emptyMessage。

方法二：正确实现LazyDataModel（懒加载场景） #

如果用的是懒加载模型，关键是要在load()方法里正确返回空结果集，并设置rowCount为0：

import java.util.List;
import java.util.Map;
import org.primefaces.model.LazyDataModel;
import org.primefaces.model.SortOrder;

public class YourLazyModel extends LazyDataModel<YourEntity> {

    @Override
    public List<YourEntity> load(int first, int pageSize, String sortField, SortOrder sortOrder, Map<String, Object> filters) {
        // 执行懒加载过滤查询，获取当前页数据
        List<YourEntity> filteredData = yourLazyFilterQuery(first, pageSize, filters);
        
        // 计算过滤后的总记录数：空结果时设为0
        int totalRecords = filteredData.isEmpty() ? 0 : yourFilteredTotalCountQuery(filters);
        this.setRowCount(totalRecords);
        
        return filteredData;
    }
}

页面上只需要开启lazy="true"并绑定懒模型，emptyMessage就能正常触发了。

方法三：升级PrimeFaces版本（最彻底的方案） #

这个bug在PrimeFaces 6.1及后续版本中已经被官方修复了，如果你的项目允许升级依赖，直接把PrimeFaces升到6.1或更高版本，不需要修改任何业务代码就能解决这个问题。

最后提醒几个注意点：

• 确保emptyMessage是直接设置在p:dataTable标签上，不要放在列或其他子组件里
• selectOneMenu的过滤器要使用匹配的filterMatchMode（比如exact，避免模糊匹配导致的意外结果）
• 触发过滤的JS调用要正确（比如用PF('widgetVar').filter()）

内容的提问来源于stack exchange，提问作者A. Jachs