PrimeFaces 10页面update失效：对话框内容不渲染、save方法不触发

问题根因 #

PrimeFaces的<p:dialog>组件默认会将自身DOM结构移动到HTML文档的<body>标签末尾，你当前将对话框写在了<h:form id="changelogfrm">内部，DOM移动后对话框内的所有输入组件、提交按钮就脱离了原表单范围，导致：

• 新增按钮执行update时，找不到对应DOM节点，内容无法刷新
• 对话框内的Save按钮无法触发表单提交，后端save方法不会被调用

修复方案 #

1. 调整表单与对话框结构 #

将对话框从原有表单中移出，单独为对话框内部配置独立表单，避免DOM移动导致表单脱离问题，同时修正对应ID引用路径。
修改后的页面核心代码如下：

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE composition PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
    
<ui:composition xmlns="http://www.w3.org/1999/xhtml"
    xmlns:ui="http://java.sun.com/jsf/facelets"
    xmlns:f="http://java.sun.com/jsf/core"
    xmlns:h="http://java.sun.com/jsf/html"
    xmlns:p="http://primefaces.org/ui"
    template="layout.xhtml">

    <ui:define name="header">
        <div id="header">
            ChangeLog
        </div>
    </ui:define>

    <ui:define name="main">
        <!-- 原有表单仅保留工具栏、数据表格 -->
        <h:form id="changelogfrm">
            <p:growl id="messages" showDetail="true" life="3000" />
            <div class="card">
                <p:toolbar>
                    <p:toolbarGroup>
                        <!-- 修改update路径为对话框内部表单的绝对ID -->
                        <p:commandButton value="Neu" icon="pi pi-plus" actionListener="#{changeloghandler.newChangelog}"
                                         update=":manageChangeFrm:manage-change-content" oncomplete="PF('manageChangeDialog').show()"
                                         styleClass="ui-button-success" style="margin-right: .5rem" />
                    </p:toolbarGroup>
                </p:toolbar>
                <p:dataTable var="change" value="#{changeloghandler.changeLogs}"
                    showGridlines="true" size="small" id="dtChange">
                    <p:column headerText="Version">
                        <h:outputText value="#{change.version}" />
                    </p:column>
        
                    <p:column headerText="Typ">
                        <h:outputText value="#{change.changeType}"/>
                    </p:column>
        
                    <p:column headerText="Beschreibung">
                        <h:outputText value="#{change.description}"/>
                    </p:column>
        
                    <p:column headerText="Datum">
                        <h:outputText value="#{change.date}">
                            <f:convertDateTime type="date" pattern="dd.MM.yyyy HH:mm"/>
                        </h:outputText>
                    </p:column>
                </p:dataTable>
            </div>
        </h:form>

        <!-- 对话框移到表单外部，内部新增独立表单 -->
        <p:dialog header="Change" showEffect="fade" modal="true"
                  widgetVar="manageChangeDialog" responsive="true">
            <h:form id="manageChangeFrm">
                <p:outputPanel id="manage-change-content" class="ui-fluid">
                    <p:outputPanel rendered="#{not empty changeloghandler.selected}">
                        <div class="p-field">
                            <p:outputLabel for="chBeschreibung">Beschreibung</p:outputLabel>
                            <p:inputTextarea id="chBeschreibung" value="#{changeloghandler.selected.description}" required="true"/>
                        </div>
                    </p:outputPanel>
                </p:outputPanel>
    
                <f:facet name="footer">
                    <p:commandButton value="Save" icon="pi pi-check" actionListener="#{changeloghandler.save}"
                                     update="manage-change-content" process="manage-change-content @this"/>
                    <p:commandButton value="Cancel" icon="pi pi-times" onclick="PF('manageChangeDialog').hide()"
                                     class="ui-button-secondary"/>
                </f:facet>
            </h:form>
        </p:dialog>
    </ui:define>
</ui:composition>

2. 可选优化（若仍存在更新异常） #

可在<p:dialog>标签上添加appendTo="@this"属性，强制对话框DOM不移动到body末尾，完全避免ID路径解析问题：

<p:dialog header="Change" showEffect="fade" modal="true" appendTo="@this"
          widgetVar="manageChangeDialog" responsive="true">

3. 后端代码优化（可选） #

save方法中更新数据表格的ID可改为绝对路径，避免跨表单更新异常：

PrimeFaces.current().ajax().update(":changelogfrm:dtChange");

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